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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI Technical Committee Smart Card Platform (SCP). 

The contents of the present document are subject to continuing work within TC SCP and may change following formal 
TC SCP approval. If TC SCP decides to modify the contents of the present document, it will be re-released by EP SPC 
with an identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document covers the minimum characteristics considered necessary in order to provide compliance to 
TS 102 588 [2]. 

It describes the technical characteristics and methods for testing the SCWS API for Java Card™ (TS 102 588 [2]) 
implemented in a UICC platform. It specifies the following parts: 

test applicability; 

test environment description; 

tests format; 

test area reference; 

conformance requirements; 

test suite files; 

test procedure; 

test coverage; and 

a description of the associated testing tools that shall be used. 



2 References 

References are either specific (identified by date of publication and/or edition number or version number) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• In the case of a reference to a TC SCP document, a non specific reference implicitly refers to the latest version 
of that document in the same Release as the present document. 

• Non-specific reference may be made only to a complete document or a part thereof and only in the following 

cases: 

if it is accepted that it will be possible to use all future changes of the referenced document for the 
purposes of the referring document; 

for informative references. 

Referenced documents which are not found to be publicly available in the expected location might be found at 
http://docbox.etsi.org/Reference . 

NOTE: While any hyperlinks included in this clause were vaUd at the time of publication ETSI cannot guarantee 
their long term validity. 

2.1 Normative references 

The following referenced documents are indispensable for the application of the present document. For dated 
references, only the edition cited applies. For non-specific references, the latest edition of the referenced document 
(including any amendments) applies. 

[1] ISO/IEC 9646-7 (1995): "Information technology - Open Systems Interconnection - Conformance 

testing methodology and framework - Part 7: Implementation Conformance Statements". 
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[2] ETSI TS 102 588: "Smart Cards; Application invocation Application Programming Interface 

(API) by a UICC webserver for Java Card'"^ platform". 

[3] ETSI TS 102 483: "Smart cards; UICC-Terminal interface; Internet Protocol connectivity between 

UICC and terminal". 

[4] OMA: "Smartcard -Web Server Enable Architecture", OMA-AD-Smartcard-Web-Server-Vl-0- 

20080421 -A. 

NOTE: Available at http://www.openmobilealliance.org/technical/release program/SCWS vl O.aspx . 

[5] OMA: "Smartcard-Web-Server", OMA-TS-Smartcard-Web-Server-Vl-O-20080421-A. 

NOTE: Available at http://www.openmobilealliance.org/technical/release program/SCWS vl O.aspx . 

[6] Sun Microsystems Java Card'''^ Specification: "Java Card'"^ 2.2.2 Application Programming 

Interface". 

[7] Sun Microsystems Java Card^*^ Specification: "Java Card'^'^ 2.2.2 Runtime Environment 

Specification". 

[8] Sun Microsystems Java Card''"*^ Specification: "Java Card'''^ 2.2.2 Virtual Machine Specification". 

NOTE: SUN Java Card Specifications can be downloaded at http://iava.sun.com/products/iavacard . 

[9] ETSI TS 102 268: "Smart Cards; Test specification for the UICC Application Programming 

Interface (AP)I for Java CardT^". 

[10] ETSI TS 101 220: "Smart Cards; ETSI numbering system for telecommunication application 

providers". 

[11] ETSI TS 102 223: "Smart Cards; Card Application Toolkit (CAT)". 

[12] ETSI TS 102 241: "Smart Cards; UICC Application Programming Interface (UICC API) for Java 

Card(TM)". 

[13] ETSI TS 102 221: "Smart Cards; UICC-Terminal interface; Physical and logical characteristics". 

2.2 Informative references 

The following referenced documents are not essential to the use of the ETSI deliverable but they assist the user with 
regard to a particular subject area. For non-specific references, the latest version of the referenced document (including 
any amendments) applies. 

[i.l] ETSI TS 102 600: "Smart Cards; UICC-Terminal interface; Characteristics of the USB interface". 

[i.2] HttpClient project. 

NOTE: Available at http://hc.apache.org/httpcomponents-client/index.html . 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply: 

applet installation parameters: values for applet installation parameters 

Conformance Requirement Reference (CRR): description of the expected SCWS behaviour according to 
TS 102 588 [2] 
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expected state: state in which the UICC is supposed to be after the execution of the test procedure applied on the 
relevant initial conditions 

security parameters: minimum security requirements defined for the applet installation process 

test area: set of Test Cases applicable to a specific part (class method, SCWS RE behaviour, etc.) of TS 102 588 [2] 

test case: elementary test that checks for compliance with one or more Conformance Requirement References 

test procedure: sequence of actions/commands to perform all the test cases defined in a test area 

test source file: Java file containing methods that will load and install test applet in the card, execute and verify the test 
results, and restore the Default Initial Conditions on the UICC (when possible) 

test toolkit applet: applet designed to test a specific functionality of the SCWS API (TS 102 588 [2]) 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

AID Application IDentifier 

API Application Programming Interface 

BIP Bearer Independent Protocol according to TS 102 223 [11] 

CAT Card Application Toolkit 

CRR Conformance Requirements Reference 

CRRC Conformance Requirement Reference Context Error 

CRRN Conformance Requirement Reference Normal 

CRRP Conformance Requirement Reference Parameter Error 

FES For Further Study 

IP Internet Protocol 

JCRE Java Card'"*^ Run-time Environment 

HTTP HyperText Transfer Protocol 

RE Runtime Environment 

SCWS Smart Card based Web Server according to OMA specifications [4] and [5] 

USB Universal Serial Bus interface according to TS 102 600 [i.l] 

4 Applicability 

4.1 Applicability of the present document 

This present test specification applies to UICCs containing a SCWS invocation API according to TS 102 588 [2]. 

4.2 Applicability of the individual test cases 

Table A. 1 lists the optional features for which the supplier of the implementation states the support. 

4.3 Applicability to different Releases 

The applicability to different releases specified in table B.l of the present document shall apply, unless otherwise 
specified. 
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4.4 



Definitions 



4.4.1 Format of table of the table of optional features 

The columns in table A. 1 have the following meaning. 



Column 


Meaning 


Option: 


The optional feature supported or not by tlie implementation. 


Status: 


See clause 4.4.3 'Status and Notations' 


Support: 


The support columns shall be filled in by the supplier of the implementation. The following common 
notations, defined in ISO/IEC 9646-7 [1], are used for the support column in table A.1. 
Y or y supported by the implementation 
N or n not supported by the implementation 

N/A, n/a or - no answer required (allowed only if the status is N/A, directly or after evaluation of a 
conditional status) 


Mnemonic: 


The mnemonic column contains mnemonic identifiers for each item. 



4.4.2 Format of the applicability table 

The applicability of every test in table B. 1 is formally expressed by the use of Boolean expression defined in the 
following clause. 

The columns in table B.l have the following meaning. 



Column 


Meaning 


Test case: 


The "Test case" column gives a reference to the test case number(s) detailed in the present document 
and required to validate the implementation of the corresponding item in the "Description" column 






Release: 


The "Release" column gives the Release applicable and onwards, for the item in the "Test case" column 






Support: 


The "Support" column is blank in the proforma, and shall be completed by the manufacturer in respect of 
each particular requirement to indicate the choices, which have been made in the implementation. 



4.4.3 Status and Notations 

The following notations, defined in ISO/IEC 9646-7 [1], are used for the status column: 



M 
O 

N/A 

X 

O.i 

Ci 



mandatory - the capability is required to be supported. 

optional - the capability may be supported or not. 

not applicable - in the given context, it is impossible to use the capability. 

prohibited (excluded) - there is a requirement not to use this capability in the given context. 

qualified optional - for mutually exclusive or selectable options from a set. "i" is an integer which 
identifies an unique group of related optional items and the logic of their selection which is 
defined immediately following the table. 

conditional - the requirement on the capability ("M", "O", "X" or "N/A") depends on the support 
of other optional or conditional items, "i" is an integer identifying an unique conditional status 
expression which is defined immediately following the table. For nested conditional expressions, 
the syntax "IF ... THEN (IF ... THEN ... ELSE...) ELSE ..." shall be used to avoid ambiguities. 
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4.5 Table of optional features 



Table A.I : Options 



Item 


Option 


Status 


Support 


Mnemonic 


1 


ScwsExtension.doGetQ 


M 




doGet 


2 


ScwsExtension.doPostO 


M 




doPost 


3 


ScwsExtension.doHeadQ 


M 




doHead 


4 


ScwsExtension.doPutO 


M 




doPut 


5 


ScwsExtension.doDeleteQ 


M 




doDelete 


6 


ScwsExtension.doOptionsO 







doOptions 


7 


ScwsExtension.doTraceO 







doTrace 



4.6 Applicability table 



Table B.1 : Applicability of tests 



Test 
case 


Description 


Release 


Rel-7 


Support 




Class ScwsExtensionRegistry 








6.1.1.1 


Method register 


Rel-7 


M 




6.1.1.2 


IVIethod deregister 


Rel-7 


M 






Class ScwsExtensionService 








6.1.3.1 


IVIethod doDelete 


Rel-7 


M 




6.1.3.2 


IVIethod doGet 


Rel-7 


M 




6.1.3.3 


Method doHead 


Rel-7 


M 




6.1.3.4 


Method doOptions 


Rel-7 


C001 




6.1.3.5 


Method doPost 


Rel-7 


M 




6.1.3.6 


Method doPut 


Rel-7 


M 




6.1.3.7 


Method doTrace 


Rel-7 


C002 






Interface HttpRequest 








6.1.4.1 


Method findAndCopyKeywordValue 


Rel-7 


M 




6.1.4.2 


Method findAndCopyKeywordValue 


Rel-7 


M 




6.1.4.3 


Method getContentLength 


Rel-7 


M 




6.1.4.4 


Method getContentType 


Rel-7 


M 




6.1.4.5 


Method getRequestHttpVersion 


Rel-7 


M 




6.1.4.6 


Method readContent 


Rel-7 


M 




6.1.4.7 


Method readContentType 


Rel-7 


M 






Interface HttpResponse 








6.1.5.1 


Method appendContent 


Rel-7 


M 




6.1.5.2 


Method appendHeaderVariable(byte[] data, short offset, short length) 


Rel-7 


M 




6.1.5.3 


Method appendHeaderVariable (byte[] name, short nameOffset, short 
nameLength, byte[] value, short valueOffset, short valueLength) 


Rel-7 


M 




6.1.5.4 


Method appendHeaderVariable (short headerKeywordNameld, byte[] value, 
short valueOffset, short valueLength) 


Rel-7 


M 




6.1.5.5 


Method enableChunkMode 


Rel-7 


M 




6.1.5.6 


Method finalizeHeader 


Rel-7 


M 




6.1.5.7 


Method flush 


Rel-7 


M 




6.1.5.8 


Method getRemainingResponseBufferSize 


Rel-7 


M 




6.1.5.9 


Method reset 


Rel-7 


M 




6.1.5.10 


Method sendError 


Rel-7 


M 




6.1.5.11 


Method setContentType 


Rel-7 


M 




6.1.5.12 


Method writeStatusCode 


Rel-7 


M 






sews Runtime Environment: Applet state 








6.2.1.1 


Invokation of applets not in state selectable 


Rel-7 


M 




6.2.1.2 


Registration remains valid if applet is not in selectable state 


Rel-7 


M 






SOWS Runtime Environment: Exception handling 








6.2.3.1 


No exception shall be propagated as HTTP error to the terminal 


Rel-7 


M 




G001 : IF (doOptions) THEN M ELSE N/A. 
C002: IF (doTrace) THEN M ELSE N/A. 
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Test environment 



This clause specifies requirements that shall be met and the testing rules that shall be followed during the test 
procedure. 

The test cases described in the present document shall be performed independently of the interface used between the 
UICC and the terminal. In particular, any test case shall have the same result regardless of using BIP in Server Mode as 
defined in TS 102 223 [1 1] or an IP connection according to TS 102 483 [3] and TS 102 600 [i.l]. 



5.1 Test environment description 

The general architecture for the test environment is: 



TS 102 241 [12] 
and Java CardT" 



Test sews 
applet 



Applet ".cap" 



Applet 

installation 

parameter 



Test Procedure 
exchange 



APDU cmc 



APDU cmd, 
response 



V 



HTTP 
Request 



HTTP 
Response 



Conversion 
parameter 



TERMINAL 



Converter 



Loader 



APDU I/O 



APDU (BIP) 



Bip gateway 



Socket (TCP) 



USB-< 
gateway 
FFS 



K 



TS 102 221 [13] 
based 
Applications 
(e.g. SIM Applet 
or USM Applet) 
ADF File system 
Server 



Java Card''' 
package 



Scope of the Test Suite. 
' Elements of the Test Suite 







Other 

Apphcations not 
based on 
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Toolkit Applet 
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5.2 Tests format 
5.2.1 Test area reference 

Each test area is referenced as follows: 

For API Testing: 'API_[package name]_[class name]_[method name]' where 

• package name: 

uicc.scws: '1'. 

• class name: 

yyy: 3 letters for each class. 

See annex A for fall classes acronyms list. 

• method name: 

zzzz[input parameters]: 

See annex A for full methods name acronyms list. 
For sews Framework testing: API_2_[clause name]_[subclause name]' where 

• Clause name: 

xxx: 3 letters for each clause. 

See annex A for full clause acronyms list. 

• Subclause name: 

yyyy: 4 letters for each subclause. 

See annex A for full subclause acronyms list. 

5.2.1.1 Conformance requirements 

The conformance requirements are expressed in the following way: 

• Method prototype as listed in TS 102 588 [2]. 

• Normal execution: 

Contains normal execution and correct parameters limit values, each referenced as a Conformance 
Requirement Reference Normal (CRRN). 

• Parameters error: 

Contains parameter errors and incorrect parameter limit values, each referenced as a Conformance 
Requirement Reference Parameter Error (CRRP). 

• Context error: 

Contains errors due to the context the method is used in, each referenced as a Conformance Requirement 
Reference Context Error (CRRC). 
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5.2.1.2 Test area files 

The files included in the Test Area use the following naming convention: 

• Test Source: Test_[Test Area Reference]. Java 

• Test Applet: [Test Area Reference]_[Test applet number] .Java 

• Cap File: [Test Area Reference]. cap 
The applet numbers start from '1'. 

The test source shall use the common interfaces defined in annex C. 

The Cap File format is described in Java Card^"^ Virtual Machine Specification [8]. 

Test files can be run in any order. 

All files from the same test area are located in the same subfolder. 

5.2.1 .3 Test procedure 

Each test procedure contains a table to indicate the expected responses form the API and/or the HTTP level as follows: 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 




Test Case detailed description 


API and/or SOWS Frameworl< expected beliaviour. Expected response at HTTP level. 



5.2.1.4 



Test coverage 



The table above each test procedure indicates the correspondence between the Conformance Requirements Reference 
(CRR) and the different test cases. 



5.3 



Initial conditions 



The Initial Conditions are a set of general prerequisites for the (U)SIM prior to the execution of testing. For each test 
procedure described in the present document, the following rules apply to the Initial Conditions: 

• unless otherwise stated, before installing the applet(s) relevant to the current test procedure, all packages 
specific to other test procedures shall not be present. 

Prior to any test the test environment shall have the (U)SIM powered on and performed the PROFILE DOWNLOAD 
procedure. 



5.4 Package name 



Java packages integrating this Test Suite shall follow this naming convention: 

uicc.scws.test.[Test Area Reference]: Java Card packages containing Test Area References for the TS 102 588 [2] 
uicc.scws package. 

uicc.scws.test.scwsframework.[Test Area Reference]: Java Card packages containing Test Area References for the 
TS 102 588 [2] SCWS Framework. 

uicc.scws.test.util: for the Test util package defined in this Test Suite. Requires package uicc.test.util from 
TS 102 268 [9]. 

where the Test Area Reference is written in lower case. 
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The package ../uicc.scws.test.[Test Area Reference] creates the following directory structure 
../uicc/scws/test/[Test Area Reference]/Api_l _..._[! ..n] .*, where Api_l_..._[l..n].'*' are the 
different test applets Java source files used in [Test Area Reference] . 



5.5 AID coding 



The AID coding for the Test Packages, Applet classes and Applets shall be as specified in TS 101 220 [10]. In addition, 
the following TAR and Application Provider specific data values are defined for use within the present document: 

AID coding 

Bytel \ I Byte 12 | Byte 13 | Byte 14 | Byte 15 | Byte 16 | 



Application Provider specific data 



TAR 



Specified in TS 101 220 [10] 



TAR coding (3 bytes/ 24 bits): 



Ib1l 


Lb4 1 b5 [ 


|b8 1 b9 1 


b12|b13| 


|b16|b17| 


|b24| 
























1 


Applet instance number 




Applet class number 










Package number 












RFU 














Test Part Identifier 



Applet instance number. Applet Class number. Package number: 

• For package AID, package number shall start from and class and instance numbers shall be 0. 

• For class AID, package number is the number of the class package, class number shall start from 1 and 
instance shall be 0. 

• For instance AID, package and class number are the number of class and package of which instance belongs, 
and instance number shall start from 1. 

Test part Identifier (bits bl-b4): 

• 0000 reserved (as TAR= '00.00.00' is reserved for Issuer Security Domain). 

• 00 1 API uicc . sc ws . 

• 0101 sews Framework. 

• other values are RFU. 
Application Provider specific data (1 byte): 

• '00' for Package. 

• 'Or for Applet class. 

• '02' for Applet Instance. 

EXAMPLE: The AID of Package uicc.scws is 'AO 00 00 00 87 10 05 FF FF FF FF 89 20 00 00 00'. 
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5.6 Test equipment 

These clauses recommend a minimum specification for each of the items of test equipment referenced in the tests. 

5.6.1 Test tool 

This test tool shall meet the following requirements: 

• be able to send and receive HTTP messages to the SCWS in the UICC; 

• the result of I/O commands must be presented at the application layer; 

• be able to provide results of the tests; 

• shall send and/or compare all HTTP messages specified in the test files. 

5.6.2 Interfaces and classes use 

The sews test tool extends the UICC test tool defined in TS 102 268 [9]. Therefore the SCWS test tool cannot be run 
without having implemented the UICC test tool. 

The SCWS test tool shall use the interfaces and classes as defined in Annex C. They define the only allowed methods to 
write the test sources. 

Interfaces and classes are defined as follow: 

ScwsApplicationManagementService defines methods to manage applications; 

ScwsCardManagementService defines methods to manage the UICC; 

ScwsToolkitService defines methods to manage toolkit commands; 

ScwsHttpManagement defines methods to send and receive HTTP messages; 

Sews APITestCardService defines the static method to get a reference of the class implementing all interfaces. 

5.6.3 Util package 

Annex C includes Java source code of TestScwsApplet abstract class of the uicc.scws package. Each test applet shall 
extend this abstract class in order to retrieve test results when selecting it. 

5.6.4 Java Software Development Kit 

Java Card'"^ software development kit (SDK) version supported by Java Card 2.2.2 specifications ([6], [7], [8]) is 1.4.1. 

6 Test Cases 

6.1 class uicc.scws 

6.1.1 Class ScwsExtensionRegistry 

6.1.1.1 Method register 

Test Area Reference: API_l_Ser_Regi. 
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6.1 .1 .1 .1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

static void register {ScwsExtension scwsExtension, 
byte[] appid, 
short offset, 
short length) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
ScwsException 



6.1.1.1.1.1 



Normal execution 



• CRRNl: registers the scwsExtension object to the SCWS. 

6.1.1.1.1.2 Parameter Errors 

• CRRPl: if scwsExtension is null, a NullPointerException is thrown. 

• CRRP2: if appId is null, a NullPointerException is thrown. 

• CRRP3: if offset or length or both would cause access outside of the array bounds, or if length is negative an 
ArraylndexOutOfBoundsException is thrown. 



6.1.1.1.1.3 



Context errors 



• CRRCl: if the appId is already registered, an ScwsException with reason code 
SCWSEXTENS10N_REGISTRY_ERR0R is thrown. 



6.1.1.1.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 
Cap File: 

6.1.1.1.3 



Test_Api_l_Ser_Regi.java. 
Api_l_Ser_Regi_l .Java. 
Api_l_Ser_Regi.cap. 



Test coverage 



CRR number 


Test case number 


N1 


8 


P1 


1 


P2 


2 


P3 


3, 4, 5, 6, 7 


C1 


9, 10 
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6.1.1.1.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 





Instanciate an object implementing 
the scwsExtension interface 






1 


Null scwsExtension 

register { ) 


NullPointerException is thrown 




2 


Null appid 

register { ) 


NullPointerException is thrown 




3 


Offset > appld. length 

register { ) 
appld. length = 5 
offset = 6 
length = 


ArraylndexOutOfBoundsException is thrown 




4 


Offset < 

register { ) 
appld. length = 5 
offset = -1 
length = 1 


ArraylndexOutOfBoundsException is thrown 




5 


length > appld.length 

register { ) 
appld.length = 5 
offset = 
length = 6 


ArraylndexOutOfBoundsException is thrown 




6 


offset + length > appld.length 

register { ) 
appld.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsException is thrown 




7 


length < 

register { ) 
appld.length = 5 
offset = 
length = -1 


ArraylndexOutOfBoundsException is thrown 






register the object implementing the 
scwsExtension interface with the 
name "Namel" to the SCWS . 






8 


successful registration 

register { ) 

appld = (byte) 'N', (byte) 'a', 
(byte) 'm', (byte) 'e', (byte) '1' 
offset = 
length = 5 








register the same object a second 
time with the same name 






9 


unsuccessful registration 

register { ) 

appld = (byte) 'N', (byte) 'a', 

(byte) 'm', (byte) 'e', (byte) '1' 

offset = 

length = 5 


ScwsException with reason code 
SGWSEXTENSION_REGISTRY_ERROR is thrown 






retrieve a second object 
implementing the scwsExtension 
interface 






10 


register different object with the same 
appld 

register { ) 

appld = (byte) 'N', (byte) 'a', 
(byte) 'm', (byte) 'e', (byte) '1' 
offset = 
length = 5 


ScwsException with reason code 
SGWSEXTENSION_REGISTRY_ERROR is thrown 





6.1 .1 .2 Method deregister 

Test Area Reference: API_l_Ser_Dreg, Api_l_Ser_Dreg_Helper 
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6.1.1.2.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

static void deregister {ScwsExtension scwsExtension) 

throws Java . lang. Null Point erExcept ion, 
ScwsException, 
j ava . lang . SecurityException 

6.1.1.2.1.1 Normal execution 

• CRRNl: deregisters the scwsExtension object fi^om the SCWS. 

6.1.1.2.1.2 Parameter Errors 

• CRRPl: if scwsExtension is null, a NullPointerException is thrown. 

6.1.1.2.1.3 Context errors 

• CRRCl : if the scwsExtension was not registered before, an ScwsException with reason code 
SCWSEXTENSION_REGISTRY_ERROR is thrown. 

• CRRC2: if the scwsExtension was previously registered by a different JCRE context than it is used for the 
deregistration, a Java. lang. SecurityException shall be thrown. 

• CRRC3: if the scwsExtension was already deregistered, an ScwsException with reason code 
SCWSEXTENSION_REGISTRY_ERROR is thrown. 



6.1.1.2.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 

Cap File: 
Cap File: 



Test_ Api_l_Ser_Dreg.java. 
Api_l_Ser_Dreg_l .Java. 
Api_l_Ser_Dreg_Helper.java. 
Api_l_Ser_Dreg.cap. 
Api_l_Ser_Dreg_Helper.cap. 



6.1.1.2.3 



6.1.1.2.4 



Test coverage 



CRR number 


Test case number 


N1 


3 


P1 


2 


C1 


1 


02 


5 


C3 


4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 





Instanciate an object implementing 
the scwsExtension interface. 






1 


No previous registration 

deregister { ) 


ScwsException with reason code 
SCWSEXTENSION REGISTRY ERROR is tlirown 






Register the object to the SCWS 






2 


Null scwsExtension 

deregister { ) 
scwsExtension = null 


NullPointerException is thrown 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


3 


Succesful deregistration 

deregister { ) 






4 


Second deregistration 

deregister { ) 


ScwsException with reason code 
SCWSEXTENSION REGISTRY ERROR is thrown 




5 


Different context 

Request the SCWSExtension object 
from a different context and 
deregister it. 


java.lang.SecurityException is thrown 





6.1.2 Interface ScwsExtension 

This interface is implicitely tested by the tests covering the SCWSExtensionService. 

6.1.3 Class ScwsExtensionService 

6.1.3.1 Method doDelete 

Test Area Reference: Api_l_Ses_Ddel. 

6.1 .3.1 .1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void doDelete {HttpRequest request, 

HttpResponse response) 
throws ScwsException 



6.1.3.1.1.1 

• n/a. 

6.1.3.1.1.2 

• n/a. 

6.1.3.1.1.3 



Normal execution 



Parameter Errors 



Context errors 



• CRRCl : if a ScwsException with reason code METHOD_NOT_SUPPORTED was thrown by the application 
then an appropriate HTML status page is returned by the SCWS (status code 5xx, 4xx). 

6.1.3.1.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 
Cap File: 

6.1.3.1.3 



Test_Api_l_Ses_Ddel.java. 
Api_ 1 _Ses_Ddel_ 1 .j ava. 
Api_l_Ses_Ddel.cap. 



Test coverage 



CRR number 


Test case number 


C1 


1 
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6.1.3.1.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 





Instantiate an doDeleteScwsExtensionServiceObject object and 
register to the SCWS . Map the object to the path 

"/Test Api 1 Ses Ddel" in the SCWS and send a HTTP Delete request 
to the SCWS triggering the application. 






1 


Throw ScwsException with reason code METHOD_NOT_SUPPORTED 




Appropriate status 
code (4xx, 5xx) is 
returned by the 
SCWS 



6.1.3.2 Method doGet 

Test Area Reference: Api_l_Ses_Dget. 

6.1.3.2.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void doGet {HttpRequest request, 

HttpResponse response) 
throws ScwsException 



6.1.3.2.1.1 

• n/a. 

6.1.3.2.1.2 

• n/a. 

6.1.3.2.1.3 



Normal execution 



Parameter Errors 



Context errors 



• CRRCl : if an ScwsException with reason code METHOD_NOT_SUPPORTED was thrown by the 
application then an appropriate HTML status page is returned by the SCWS (status code 4xx, 5xx). 

6.1.3.2.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 
Cap File: 

6.1.3.2.3 



Test_Api_l_Ses_Dget.java. 

Api_l_Ses_Dget_l.java. 

Api_l_Ses_Dget.cap. 



Test coverage 



CRR number 


Test case number 


01 


1 
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6.1.3.2.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 





Instantiate an doGetScwsExtensionServiceObject object and 
register to the SCWS . Map the object to the path 

"/Test Api 1 Ses Dget" in the SCWS and send a HTTP Get request to 
the SCWS triggering the application. 






1 


Throw ScwsException with reason code WIETHOD_NOT_SUPPORTED 




Appropriate status 
code (4xx, 5xx) is 
returned by the 
SCWS 



6.1.3.3 Method doHead 

Test Area Reference: Api_l_Ses_Dhea. 

6.1.3.3.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void doHead {HttpRequest request, 

HttpResponse response) 
throws ScwsException 



6.1.3.3.1.1 

• n/a. 

6.1.3.3.1.2 

• n/a. 

6.1.3.3.1.3 



Normal execution 



Parameter Errors 



Context errors 



• CRRCl : if an ScwsException with reason code METHOD_NOT_SUPPORTED was thrown by the 
application then an appropriate HTML status page is returned by the SCWS (status code 4xx, 5xx). 

6.1.3.3.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 
Cap File: 

6.1.3.3.3 



Test_Api_l_Ses_Dhea.java. 

Api_l_Ses_Dhea_l.java. 

Api_l_Ses_Dhea.cap. 



Test coverage 



CRR number 


Test case number 


01 


1 
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6.1.3.3.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 





Instantiate an doHeadScwsExtensionServiceObject object and 
register to the SCWS . Map the object to the path 
"/Test Api 1 Ses Dhea" in the SCWS and send a HTTP Head request 
to the SCWS triggering the application. 






1 


Throw ScwsException with reason code IVIETHOD_NOT_SUPPORTED 




Appropriate status 
code (4xx, 5xx ) is 
returned by the 
SCWS 



6.1 .3.4 Method doOptions 

Test Area Reference: Api_l_Ses_Dopt. 

6.1.3.4.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void doOptions {HttpRequest request, 

HttpResponse response) 
throws ScwsException 



6.1.3.4.1.1 

• n/a. 

6.1.3.4.1.2 

• n/a. 

6.1.3.4.1.3 



Normal execution 



Parameter Errors 



Context errors 



• CRRCl : if a ScwsException with reason code METHOD_NOT_SUPPORTED was thrown by the application 
(which is Intercept or Non Intercept Application ) then an appropriate HTML status page is returned by the 
SCWS (status code 4xx, 5xx). 

6.1.3.4.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 
Cap File: 

6.1.3.4.3 



Test_Api_l_Ses_Dopt.java. 
Api_ 1 _Ses_Dopt_ 1 .j ava. 
Api_l_Ses_Dopt.cap. 



Test coverage 



CRR number 


Test case number 


C1 


1 
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6.1.3.4.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 





Instantiate an doOptionsScwsExtensionServiceObject object and 
register to the SCWS . Map the object to the path 
"/Test Api 1 Ses Dopt" in the SCWS and send a HTTP Options 
request to the SCWS triggering the application. 






1 


Throw ScwsException with reason code METHOD_NOT_SUPPORTED 




Appropriate status 
code (4xx, 5xx) is 
returned by the 
SCWS 



6.1.3.5 Method doPost 

Test Area Reference: Api_l_Ses_Dpos. 

6.1.3.5.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void doPost {HttpRequest request, 

HttpResponse response) 
throws ScwsException 

Normal execution 
Parameter Errors 

Context errors 

• CRRCl : if an ScwsException with reason code METHOD_NOT_SUPPORTED was thrown by the 
application then an appropriate HTML status page is returned by the SCWS (status code 4xx, 5xx). 

6.1.3.5.2 Test area files 

Specific triggering: Unrecognized envelope: 

Test Source: Test_Api_l_Ses_Dpos.java. 

Test Applet: Api_l_Ses_Dpos_l.java. 

Cap File: Api_l_Ses_Dpos.cap. 



6.1.3.5.1.1 


• n/a. 


6.1.3.5.1.2 


• n/a. 


6.1.3.5.1.3 



6.1.3.5.3 



Test coverage 



CRR number 


Test case number 


01 


1 
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6.1.3.5.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 





Instantiate an doPostScwsExtensionServiceObject object and 
register to the SCWS . Map the object to the path 
"/Test Api 1 Ses Dpos" in the SCWS and send a HTTP Post request 
to the SCWS triggering the application. 






1 


Throw ScwsException with reason code IVIETHOD_NOT_SUPPORTED 




Appropriate status 
code (4xx, 5xx) is 
returned by the 
SCWS 



6.1.3.6 Method doPut 

Test Area Reference: Api_l_Ses_Dput. 

6.1.3.6.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void doPut {HttpRequest request, 

HttpResponse response) 
throws ScwsException 

Normal execution 
Parameter Errors 

Context errors 

• CRRCl : if a ScwsException with reason code METHOD_NOT_SUPPORTED was thrown by the application 
(which is Intercept or Non Intercept Application) then an appropriate HTML status page is returned by the 
SCWS (status code 4xx, 5xx). 

6.1.3.6.2 Test area files 

Specific triggering: Unrecognized envelope: 



6.1.3.6.1.1 


• n/a. 


6.1.3.6.1.2 


• n/a. 


6.1.3.6.1.3 



Test Source: 
Test Applet: 
Cap File: 

6.1.3.6.3 



Test_Api_l_Ses_Dput.java. 
Api_l_Ses_Dput_l .Java. 
Api_ 1 _Ses_Dput. cap . 



Test coverage 



CRR number 


Test case number 


C1 


1 



£75/ 



(Release 7) 



27 



ETSI TS 102 835 V7.0.0 (2010-04) 



6.1.3.6.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 





Instantiate an doPutScwsExtensionServiceObject object and 
register to the SCWS . Map the object to the path 

"/Test Api 1 Ses Dput" in the SCWS and send a HTTP Put request to 
the SCWS triggering the application. 






1 


Throw ScwsException with reason code METHOD_NOT_SUPPORTED 




Appropriate status 
code (4xx, 5xx ) is 
returned by the 
SCWS 



6.1.3.7 Method doTrace 

Test Area Reference: Api_l_Ses_Dtra. 

6.1.3.7.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void doTrace {HttpRequest request, 

HttpResponse response) 
throws ScwsException 

Normal execution 
Parameter Errors 



Context errors 

• CRRCl : if a ScwsException with reason code METHOD_NOT_SUPPORTED was thrown by the application 
(which is Intercept or Non Intercept Application ) then an appropriate HTML status page is returned by the 
SCWS (status code 4xx, 5xx). 

6.1.3.7.2 Test area files 

Specific triggering: Unrecognized envelope: 



6.1.3.7.1.1 


• n/a. 


6.1.3.7.1.2 


• n/a. 


6.1.3.7.1.3 



Test Source: 
Test Applet: 
Cap File: 

6.1.3.7.3 



Test_Api_l_Ses_Dtra.java. 
Api_l_Ses_Dtra_l .Java. 
Api_ 1 _Ses_Dtra. cap . 



Test coverage 



CRR number 


Test case number 


C1 


1 
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6.1.3.7.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 





Instantiate an doTraceScwsExtensionServiceObject object and 
register to the SCWS. Map the object to the path 

"/Test Api 1 Ses Dtra" in the SCWS and send a HTTP Trace request 
to the SCWS triggering the application. 






1 


Throw ScwsException with reason code METHOD_NOT_SUPPORTED 




Appropriate status 
code (4xx, 5xx) is 
returned by the 
SCWS. 



6.1.4 Interface HttpRequest 

6.1.4.1 Method findAndCopyKey word Value 

Test Area Reference: Api_l_Hrq_Fckw. 



6.1.4.1.1 



Conformance Requirement 



The method with following header shall be compliant to its definition in the API. 

short f indAndCopyKeywordValue {byte [] headerKeywordName , 

short nameOffs, 
short nameLength, 
byte [] buffer, 
short bufferOffs, 
short maxLength) 
throws : Java . lang.NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException. 

6.1 .4.1 .1 .1 Normal execution 

• CRRN 1 : Find and copy the value of a header. 

• CRRN2: bufferOffs+length of the copied value or KEYWORD_NOT_FOUND in case the keyword is not 
found. 

6.1.4.1.1.2 Parameter Errors 

• CRRPl: if headerKeywordName is equal to null a java.lang.NullPointerException is thrown. 

• CRRP2: if buffer is equal to null a NullPointerException is thrown. 

• CRRP3: if the copy operation would cause access out of bounds an ArraylndexOutOfBoundsException is 
thrown. 



6.1.4.1.1.3 
• n/a. 



Context errors 



6.1.4.1.2 Test area files 

Specific triggering: Unrecognized envelope: 

Test Source: Test_Api_l_Hrq_Fckw_Bss_Bss.java. 

Test Applet: Api_l_Hrq_Fckw_Bss_Bss_l.java. 

Cap File: Api_l_Hrq_Fckw_Bss_Bss.cap. 
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Test coverage 



CRR number 


Test case number 


P1 


1 


P2 


2 


P3 


3, 4, 5, 6, 7 


N1 


9 


N2 


8 



6.1.4.1.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


1 


findAndCopyKeywordValue () with a null 
headerKeywordName 


NullPointerException is thrown 




2 


findAndCopyKeywordValue () with a null buffer 


NullPointerException is thrown 




3 


bufferOffs > buffer.length 

findAndCopyKeywordValue () 
nameOffs = 
buffer.length = 2 
bufferOffs = 2 
maxLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




4 


bufferOffs < 

findAndCopyKeywordValue ( ) 
buffer.length = 2 
bufferOffs = -1 
maxLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




5 


maxLength > buffer.length 

findAndCopyKeywordValue ( ) 
buffer.length = 2 
bufferOffs = 
maxLength = 3 


ArraylndexOutOfBoundsException is 
thrown 




6 


bufferOffs + maxLength > buffer.length 

findAndCopyKeywordValue ( ) 
buffer.length = 2 
bufferOffs = 1 
maxLength = 2 


ArraylndexOutOfBoundsException is 
thrown 




7 


maxLength < 

findAndCopyKeywordValue ( ) 
buffer.length = 2 
bufferOffs = 
maxLength = -1 


ArraylndexOutOfBoundsException is 
thrown 




8 


findAndCopyKeywordValue ( ) 

headerKeywordName= HEADER AB [ This header is 
not present in the request] 
bufferOffs = 


ScwsGonstants.KEYWORD NOT FOU 
ND 




9 


findAndCopyKeywordValue ( ) 

headerKeywordName= HEADER AB [ This header is 
present in the request] 
bufferOffs = 1 


lenght of Header AB (1) + bufferOffs (1) 
= 2 





6.1 .4.2 Method findAndCopyKeywordValue 

Test Area Reference: Api_l_Hrq_Fckw. 
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6.1.4.2.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

short findAndCopyKeywordValue {short keywordid, 

byte [] buffer, 
short bufferOffs, 
short maxLength) 
throws ScwsException, 

NullPointerException, 
ArraylndexOutOfBoundsException 



6.1.4.2.1.1 



Normal execution 



• CRRNl Find and copy the value of a header or the value of a keyword/value part of the URI indicated by a 
keywordid. The supported keywords are defined in ScwsConstants Interface. 

6.1 .4.2.1 .2 Parameter Errors 

• CRRPl KEYWORD_NOT_FOUND in case the keyword is not found. 

• CRRP2 if the keywordid is not recognized a ScwsException - with reason UNKNOWN_KEYWORD_ID. 

• CRRP3: if buffer is equal to null a NullPointerException is thrown. 

• CRRP4: if the copy operation would cause access out of bounds an ArraylndexOutOfBoundsException is 
thrown. 



6.1.4.2.1.3 
• n/a. 



Context errors 



6.1.4.2.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 
Cap File: 

6.1.4.2.3 



Te s t_ Api_ 1 _Hrq_Fckws_B s s . j a va . 
Api_l_Hrq_Fckws_Bss_l .Java. 
Api_l_Hrq_Fckws_Bss.cap. 



Test coverage 



CRR number 


Test case number 


P1 


1 


P2 


2 


P3 


19 


P4 


20,21,22,23,24 


N1 


3,4,5,6,7,8,9, 10, 11, 
12, 13, 14, 15, 16, 17, 18 
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6.1.4.2.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


1 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_ACCEPT_ENCODING 
[not present in request] 
bufferOffs = 


ScwsConstants.KEYWORD_NOT_FOUND 




2 


f IndAndCopyKeywordValue { ) 
keywordid = 99 (Unknown) 
bufferOffs = 


ScwsException - with reason 

U]SrK]SrOWN_KE YWORD_I D 




3 


f indAndCopyKeywordValue { ) 
keywordid = ScwsConstants .HEADER_ACCEPT 
[present in request] 
bufferOffs = 






4 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_ACCEPT_CHARSET 
[present in request] 
bufferOffs = 






5 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_ACCEPT_ENCODING 
[present in request] 
bufferOffs = 






6 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_ACCEPT_LANGUAGE 
[present in request] 
bufferOffs = 






7 


f indAndCopyKeywordValue { ) 
keywordid = ScwsConstants .HEADER HOST 
[present in request] 
bufferOffs = 






8 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_USER_AGENT 
[present in request] 
bufferOffs = 






9 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_CONTENT_ENCODING 
[present in request] 
bufferOffs = 






10 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_CONTENT_LANGUAGE 
[present in request] 
bufferOffs = 






11 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_CONTENT_LENGTH 
[present in request] 
bufferOffs = 






12 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_CONTENT_TYPE 
[present in request] 
bufferOffs = 






13 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_SERVER 
[present in request] 
bufferOffs = 






14 


f indAndCopyKeywordValue { ) 
keywordid = ScwsConstants .URI_TAG 
[present in request] 
bufferOffs = 






15 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .URI_SCHEMA_TAG 
[present in request] 
bufferOffs = 






16 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .URI_AUTHORITY_TAG 
[present in request] 
bufferOffs = 






17 


f indAndCopyKeywordValue { ) 
keywordid = ScwsConstants .URI_PATH_TAG 
[present in request] 
bufferOffs = 






18 


f indAndCopyKeywordValue { ) 
keywordid = ScwsConstants .URI_QUERY_TAG 
[present in request] 
bufferOffs = 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


19 


f indAndCopyKeywordValue { ) with a null buffer 


NullPointerException is thrown 




20 


bufferOffs > buffer.length 

f IndAndCopyKeywordValue {) 
buffer.length = 2 
bufferOffs = 3 
maxLength = 1 


ArraylndexOutOfBoundsException is 
tlirown 




21 


bufferOffs < 

f IndAndCopyKeywordValue { ) 
buffer.length = 2 
bufferOffs = -1 
maxLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




22 


maxLength > buffer.length 

f IndAndCopyKeywordValue { ) 
buffer.length = 2 
bufferOffs = 
maxLength = 3 


ArraylndexOutOfBoundsException is 
thrown 




23 


bufferOffs + maxLength > buffer.length 

f IndAndCopyKeywordValue { ) 
buffer.length = 2 
bufferOffs = 1 
maxLength = 2 


ArraylndexOutOfBoundsException is 
thrown 




24 


maxLength < 

f IndAndCopyKeywordValue { ) 
buffer.length = 2 
bufferOffs = 
maxLength = -1 


ArraylndexOutOfBoundsException is 
thrown 





6.1.4.3 



Method getContentLength 



This test case is FFS. 



6.1.4.4 



Method getContentType 



This test case is FFS. 

6.1.4.5 Method getRequestHttpVersion 

Test Area Reference: Api_l_Hrq_Grhv 

6.1.4.5.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

short getRequestHttpVersion { ) 

6.1.4.5.1.1 Normal execution 

• CRRNl : Returns the version of the HTTP protocol of the current request. 

6.1 .4.5.1 .2 Parameter Errors 

• None. 



6.1.4.5.1.3 
• None. 



Context errors 
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Test Source: 
Test Applet: 
Cap File: 

6.1.4.5.3 



Test_Api_ 1 _Hrq_Grhv.j ava. 
Api_l_Hrq_Grhv_l .Java. 
Api_l_Hrq_Grhv.cap. 



Test coverage 



CRR number 


Test case number 


N1 


1,2 



6.1.4.5.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


1 


Normal execution 

Send a HTTP request with protocol version 
set to: HTTP/1.0. 


Returns 
ScwsConstants.HTTP_PROTOCOL_VERSION_10 




2 


Normal execution 

Send a HTTP request with protocol version 
set to: HTTP/1.1. 


Returns 
ScwsConstants.HTTP_PROTOCOL_VERSION_11 





6.1.4.6 Method readContent 

Test Area Reference: Api_l_Hrq_Rcon. 

6.1.4.6.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

short readContent {int requestOf f set , 
byte [] data, 
short offset, 
short len) 
throws: ScwsException 

Java . lang.NulPointerException 

Java . lang. ArraylndexOutOfBoundsException 

6.1.4.6.1.1 Normal execution 

• CRRN 1 : Read a part of the request content and copy it in the data buffer. 

6.1 .4.6.1 .2 Parameter Errors 

• CRRPl: if the data buffer is equal to null, a java.lang.NuU PointerException is thrown. 

• CRRP2: if the copy operation would cause access out of bounds, a 
java.lang./VrraylndexOutOfBoundsException will be thrown. 

• CRRP3: if the requested offset is out of the request bounds, a ScwsException.UNREACHABLE_OFFSET 
will be thrown. 



6.1.4.6.1.3 
• None. 



Context errors 
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Test Source: 
Test Applet: 
Cap File: 

6.1.4.6.3 



Test_Api_l_Hrq_Rcon.java. 
Api_ 1 _Hrq_Rcon_ 1 .j ava. 
Api_ 1 _Hrq_Rcon. cap. 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


PI 


3 


P2 


4, 5, 6, 7, 8 


P3 


9, 10 



6.1.4.6.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


1 


Normal execution 

Send a request with Content-length set to 

0x2 

readContent { ) 

requestOf f set = 

offset = 

len = 0x10 


Data buffers contains the first bytes of the 
request content 




2 


Normal execution 

Send a request with Content-length set to 

0x2 

readContent { ) 

requestOf f set = 

offset = 

len = 0x20 


Data buffers contains the entire request content 




3 


Null pointer exception 

Send a request with Content -length set to 

0x2 

readContent { ) 

data[] is set to null 


NullPointerException is thrown 




4 


offset > data.length 

Send a request with Content-length set to 

0x2 

readContent { ) 

data.length = 0x20 

offset = 0x20 

length = 0x10 


ArraylndexOutOfBoundException is thrown 




5 


length > data.length 

Send a request with Content-length set to 

0x2 

readContent { ) 

data.length = OxlF 

offset = 0x00 

length = 0x2 


Array! ndexOutOfBound Exception is thrown 




6 


offset + length > data.length 

Send a request with Content-length set to 

0x2 

readContent { ) 

data.length = 0x20 

offset = 0x10 

length = 0x11 


ArraylndexOutOfBoundException is thrown 




7 


length < 

Send a request with Content-length set to 

0x2 

readContent { ) 

data.length = 0x20 

offset = 0x00 

length = -1 


ArraylndexOutOfBoundException is thrown 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


8 


offset < 

Send a request with Content-length set to 

0x2 

readContent { ) 

data. length = 0x2 

offset = -1 

length = 0x10 


ArraylndexOutOfBound Exception is thrown 




9 


requestOffset > request lengtfi 

Send a request with Content-length set to 

0x2 

readContent { ) 

Request length is 0x2 

requestOffset = 0x20 

data. length = 0x2 

offset = 

length = 0x10 


ScwsException.UNREACHABLE_OFFSETis 
thrown 




10 


requestOffset < 

Send a request with Content -length set to 

0x2 

readContent { ) 

Request length is 0x2 

requestOffset = -1 

data. length = 0x2 

offset = 

length = 0x10 


ScwsExceptlon.UNREACHABLE_OFFSETis 
thrown 





6.1.4.7 Method readContentType 

Test Area Reference: Api_l_Hrq_Rcty. 

6.1.4.7.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

short readContentType {byte [] data, 
short offs, 
short len) 
throws : Java . lang.NulPointerException 

Java . lang. ArraylndexOutOfBoundsException 



6.1.4.7.1.1 



Normal execution 



• CRRNl: Reads the content type given in the HTTP request and copy it in the data[ ] buffer. Returns the offset 
of the last data written in the buffer. 

6.1 .4.7.1 .2 Parameter Errors 

• CRRPl: if the data buffer is null, a java.lang.NullPointerException will be thrown. 

• CRRP2: if the copy operation would cause access out of bounds, a 
java.lang. ArraylndexOutOfBoundsException will be thrown. 



6.1.4.7.1.3 
• None. 



Context errors 



6.1.4.7.2 Test area files 

Specific triggering: Unrecognized envelope: 

Test Source: Test_Api_l_Hrq_Rcty.java. 

Test Applet: Api_l_Hrq_Rcty_l.java. 
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Api_l_Hrq_Rcty.cap. 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


P1 


3 


P2 


4, 5, 6, 7, 8 



6.1.4.7.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP 
Expectation 


1 


Normal execution 

Send a HTTP request with content type set to: text/html. 
readContentType { ) 
data. length = 0x20 
offs = 0x00 
len = OxOA 


text/html is written in the data 
buffer and tlie method returns 
0x08 




2 


Normal execution 

Send a HTTP request with content type set to: text/html. 
readContentType { ) 
data. length = 0x2 
offs = 0x00 
len = 0x05 


text/ is written in the data buffer 
and the method returns 0x04 




3 


Null pointer 

Send a HTTP request with content type set to: text/html 
readContentType { ) 
data = null 
offs = 0x00 
len = OxOA 


NullPointerException is thrown 




4 


offs > data.length 

Send a HTTP request with content type set to: text/html. 
readContentType { ) 
data.length = 0x20 
offs = 0x20 
len = 0x10 


Array IndexOutOf Bound Exception 
is thrown 




5 


len > data.length 

Send a HTTP request with content type set to: text/html. 
readContentType { ) 
data.length = 0x05 

offs = 0x00 
len = 0x09 


Array IndexOutOf Bound Exception 
is thrown 




6 


offs + len > data.length 

Send a HTTP request with content type set to: text/html. 
readContentType { ) 
data.length = 0x05 
offs = 0x01 
len = 0x05 


Array IndexOutOf Bound Exception 
is thrown 




7 


len <0 

Send a HTTP request with content type set to: text/html. 
readContent { ) 
data.length = 0x20 
offs = 0x00 
Len = -1 


Array IndexOutOf Bound Exception 
is thrown 




8 


Offs < 

Send a HTTP request with content type set to: text/html. 
readContent { ) 
data.length = 0x20 
offs = -1 
Len = 0x10 


Array IndexOutOf BoundException 
is thrown 





6.1.5 Interface HttpResponse 

6.1.5.1 Method appendContent 

Test Area Reference: Api_l_Hrs_Acon. 
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6.1 .5.1 .1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void appendContent {byte [] data, 
short offset, 
short length) 
throws ScwsException 

6.1.5.1.1.1 Normal execution 

• CRRNl: Writes the content of data into the HttpResponse. 

• CRRN2: Invoking this method implicitly finalizes the header of the HttpResponse. 

• CRRN3: In case of chunked transfer encoding hex length of chunked data is automatically added by the 
framework. 

6.1.5.1.1.2 Parameter Errors 

• CRRPl: if data is null, a java.lang.NuUPointerException is thrown. 

• CRRP2: if parameter offset is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if parameter length is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP4: if parameter offset plus length are greater than the length of array data, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 



6.1.5.1.1.3 



Context errors 



• CRRCl : if appending the content would cause an overflow of the response buffer, a uicc. sews. ScwsException 
with reason codes BUFFER_OVERFLOW is thrown. 

• CRRC2: if the flush method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC3: if the sendError method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.1.2 Test area files 

Specific triggering: None: 



Test Source: 
Test Applet: 
Cap File: 

6.1.5.1.3 



Test_Api_ 1 _Hrs_Acon.j ava. 
Api_l_Hrs_Acon _l.java. 
Api_l_Hrs_Acon.cap. 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5, 14 


N2 


4 


N3 


2, 14 


P1 


6 


P2 


7 


P3 


8 


P4 


9 


C1 


12, 13 


02 


10 


C3 


11 
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6.1.5.1.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


1 


append chunk off 

writeStatusCode (200) 
f inalizeHeader { ) 

appendContent { 
data = [Hello World] 
offset = 
length = 6) 

appendContent { 
data = [Hello World] 
offset = 6 
length = 5) 

flush {) 




HTTPResponse { 
StatusCode = "200" 
Header {"Content-Length" ) = "11" 
contentBody = "Hello World" 

) 


2 


append chunk on 

writeStatusCode (200) 
enableChunlcMode { ) 
f inalizeHeader { ) 

appendContent { 

data = [Hello World] 

offset = 

length = 6) 
appendContent { 

data = [Hello World] 

offset = 6 

length = 5) 

flush {) 




HTTPResponse { 

StatusCode = "200" 

Header {"Transfer-Encoding") = 
"chunked" 

contentBody = "Hello World" 
) 


3 


append up to remaining 
buffer length 

writeStatusCode (200) 
f inalizeHeader { ) 

appendContent { 
data = 'aaa . . . ' 
offset = 
length = 

remainingBuf f erLength) 

flush {) 




HTTPResponse { 
StatusCode = "200" 
Header { "Content-Length" ) = 

bufferLength 

contentBody = "aaa..." 
) 


4 


append implicitly finalizes 
the header 

writeStatusCode (200) 

appendContent { 
data= [Hello World] 
offset= 
length= 11) 

flush {) 




HTTPResponse { 
StatusCode = "200" 
Header {"Content-Length") = "11" 
contentBody = "Hello World" 

) 


5 


length = 

writeStatusCode (200) 
f inalizeHeader { ) 

appendContent { 
data = [Hello World] 
offset= 
length^ 0) 

flush {) 




HTTPResponse { 

StatusCode = "200" 

Header {"Content-Length") = "0" 

contentBody = " " 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


6 


data[] is null 

appendContent { 
data= null 
offset = 
length = 10) 


java.lang.NullPointerException is thrown : 
Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

statusCode = "204" 
) 


7 


offset<0 

appendContent { 
data = [Hello World] 
offset = -1 
length = 10) 


java.lang.ArraylndexOutOfBoundsExceptio 
n is thrown. 

Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


8 


length<0 

appendContent { 
data = [Hello World] 
offset = 
length = -1) 


Java. lang.ArraylndexOutOfBoundsExce 
ption is thrown. 

Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


9 


offset + length > data.length 

appendContent { 
data = [Hello World] 
offset = 10 
length = 11) 


Java. lang.ArraylndexOutOfBoundsExce 
ption is thrown. 

Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


10 


flush called previously 

writeStatusCode (200) 
f inalizeHeader { ) 
appendContent { 

data = 'Hello' 

offset = 

length = 5) 
flush 

appendContent { 
data = 'World' L 
offset = 
length =5) 


uicc. sews . ScwsException with reason 
codes HTTP_RESPONSE_ALREADY_SENT is 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse { 

StatusCode = "200" 

Header { "Content-Length" ) = "5" 

contentBody = "Hello" 
) 


11 


sendError called previously 

sendError (500) 

appendContent { 
data = 'World' 
offset =0 r 
length = 5) 


uicc . sews . ScwsException with reason 
codes HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse { 

StatusCode = "500" 
) 


12 


response buffer overflow 

writeStatusCode (200) 
f inalizeHeader { ) 

appendContent { 
data = 'aaa . . . ' 
offset =0 l 
length = 

responseBuf f er+1) 


uicc . sews . ScwsException with reason 
codes BUFFER_OVERFLOW iS thrown. 

Catch the exception and continue the 
procedure. 


HTTPResponse ( 

StatusCode = "200" 

Header {"Content -Length") = "0" 

contentBody = " " 
) 


13 


Void 






14 


Void 






15 


Not present 

writeStatusCode (200) 
f inalizeHeader { ) 
flush {) 




HTTPResponse { 
StatusCode = "200" 
Header {"Content-Length") = "0" 

ContentBody = "" 
) 
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6.1 .5.2 Method appendHeaderVariable(byte[] data, short offset, short length) 

Test Area Reference: Api_l_Hrs_Ahva_Bss. 

6.1.5.2.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void appendHeaderVariable {byte [] data, 

short offset, 
short length) 
throws ScwsException 

6.1.5.2.1.1 Normal execution 

• CRRNl: Writes a header variable to outgoing buffer, "CRLF" will be appended automatically. 

• CRRN2: The header variables content-length or transfer-encoding are inserted by the framework depending on 
the transfer mode. 

6.1 .5.2.1 .2 Parameter Errors 

• CRRPl: if data is null, a java.lang.NuUPointerException is thrown. 

• CRRP2: if parameter offset is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if parameter length is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP4: if parameter offset plus length are greater than the length of array data, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

6.1.5.2.1.3 Context errors 

• CRRCl : if the HTTP header was already finalized, a uicc. sews. ScwsException with reason codes 
HEADER. ALREADY_FINALIZED is thrown. 

• CRRC2: if appending the header variable would cause an overflow of the response buffer, a 
uicc. sews. ScwsException with reason codes BUFFER_OVERFLOW is thrown. 

• CRRC3: if the flush method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC4: if the sendError method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.2.2 Test area files 

Specific triggering: None: 

Test Source: Test_ Api_l_Hrs_Ahva_Bss.java. 

Test Applet: Api_l_Hrs_Ahva_Bss_l.java. 

Cap File: Api_l_Hrs_Ahva_Bss.cap. 
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Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,2,3,4 


P1 


5 


P2 


6 


P3 


7 


P4 


8 


C1 


9, 10 


C2 


11 


C3 


12 


C4 


13 



6.1.5.2.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


1 


Basic 

writeStatusCode {200) 

appendHeaderVariable { 
data= [A: B] , 
offset= 0, 
length= 4) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse { 

StatusCode = "200" 

Header {"A") = "B" 

Header { "Content -Length " ) = "2" 

contentBody = "OK" 
) 


2 


offset>0 

writeStatusCode {200) 

appendHeaderVariable { 
data= [A: BC : Dd] , 
offset= 4, 
length= 5) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header {"C")= "Dd" 

Header {"Content-Length" ) = "2" 

contentBody= "OK" 
) 


3 


No SP char 

writeStatusCode {200) 

appendHeaderVariable { 
data= [A:B] , 
offset= 0, 
length= 3) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header { "A" )= "B" 

Header { " Content - Length " ) = " 2 " 

contentBody= "OK" 
) 


4 


length = 

writeStatusCode {200) 

appendHeaderVariable { 
data= [A: B] , 

offset = 0, 
length = 0) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header {"Content-Length" ) = "2" 

contentBody= "OK" 
) 


5 


data[] is null 

appendHeaderVariable { 
data = null, 
offset = 0, 
length = 2) 


Java . lang.NullPointerException 
is thrown. 

Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


6 


offset<0 










appendHeaderVariable { 


j ava . lang . ArraylndexOutOf Bounds 
Exception is thrown. 


HTTPResponse { 
statusCode = "204" 






data= [A: B] , 


Catch the exception and build a page with 


] 






offset= -1, 


status code = 204 


1 






length= 4) 








7 


Length<0 










appendHeaderVariable { 


j ava . lang . ArraylndexOutOf Bounds 
Exception is thrown. 


HTTPResponse { 
StatusCode = "204" 






data = [A: B] , 


Catch the exception and build a page with 


] 






offset = 0, 


status code = 204 


1 






length = -1) 








8 


valueOffset + valueLength > 










value.length 

appendHeaderVariable { 
data = [A: B] , 


j ava . lang . ArraylndexOutOf Bounds 
Exception is thrown. 
Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 






valueOffset= 1, 










length = 4) 








9 


finalizeHeader called previously 

writeStatusCode (200) 
appendHeaderVariable { 

data = [A: B] , 

valueOffset= 0, 

length = 4) 




HTTPResponse { 
statusCode= "200" 






finalizeHeader { ) ; 




Header { "A" )= "B" 

Header { "Content-Length" ) = 


"2" 


appendHeaderVariable { 


Uicc . sews . ScwsException with 




data = [C: D] , 1 


reason codes 


HeaderNotPresent {"C" ) 






valueOffset= 0, f 


HEADER_ALREADY_FINALIZED iS 


contentBody= "OK" 






length =4) J 


thrown. 

Catch the exception and continue the 

procedure. 


) 






appendContent { [OK] ,0,2) ; 










flush {) ; 








10 


appendContent called previously 

writeStatusCode (200) 

appendHeaderVariable { 
data = [A: B] , 
valueOffset= 0, 
length = 4) 




HTTPResponse { 
statusCode= "200" 
Header { "A" )= "B" 






appendContent { [OK] ,0,2) ; 




Header { "Content -Length" ) = 

HeaderNotPresent {"C" ) 


"2" 




appendHeaderVariable { "^ 


uicc . sews . ScwsException with 


contentBody= "OK" 






data = [C: D] , 1 


reason codes 


) 






valueOffset= 0, f 


HEADER_ALREADY_FINALIZED iS 








length =4) J 


thrown. 

Catch the exception and 
continue the procedure. 








flush {) ; 








11 


BUFFER_OVERFLOW 












uicc . sews . ScwsException with 


HTTPResponse ( 






writeStatusCode (200) 


reason codes BUFFER_OVERFLOW iS 


StatusCode = "200" 






appendHeaderVariable { 


thrown. 


Header { " Content - Length " ) = 


"0" 




data = [A: BbB . . .] , 


Catch the exception and 


HeaderNotPresent { "A" ) 






valueOffset= 0, 


continue the procedure. 


). 






length = remainingBuf f erLength+1) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


12 
13 


flush called previously 

writeStatusCode (200) 

appendHeaderVariable { 
data = [A: B] , 
valueOffset= 0, 
length = 4) 

appendContent { [OK] ,0,2) ; 
flush {) ; 

appendHeaderVariable { "~ 
data = [C: D] , 
valueOffset= 0, 
length = 4) 


>- 


uicc . sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse { 

statusCode= "200" 

Header { "A" )= "B" 

Header {"Content -Length " ) = "2" 

HeaderNotPresent {"C" ) 

contentBody= "OK" 
) 


sendError called previously 

sendError (500) 

appendHeaderVariable { "^ 
data = [A: B] , 

valueOffset= 0, > 
length = 4) 


uicc . sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse { 
statusCode= "500" 
HeaderNotPresent { "A" ) 

) 



6.1 .5.3 Method appendHeaderVariable (byteQ name, short nameOffset, short 

nameLength, byte[] value, short valueOffset, short valueLength) 

Test Area Reference: Api_l_Hrs_Ahva_Bss_Bss. 

6.1.5.3.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void appendHeaderVariable {byte [] name, 

short nameOffset, 
short nameLength, 
byte [] value, 
short valueOffset, 
short valueLength) 
throws ScwsException 



6.1.5.3.1.1 



Normal execution 



• CRRNl: Appends a header variable to outgoing. The colon and space (":") as well as the "CRLF" will be 
appended automatically. 

• CRRN2: The header variables content-length or transfer-encoding are inserted by the framework depending on 
the transfer mode. 

6.1 .5.3.1 .2 Parameter Errors 

• CRRPl: if name is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if value is null, a java.lang.NullPointerException is thrown. 

• CRRP3: if parameter nameOffset is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP4: if parameter nameLength is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP5: if parameter nameOffset plus nameLength are greater than the length of array name, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 
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• CRRP6: if parameter valueOffset is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP7: if parameter valueLength is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP8: if parameter valueOffset plus valueLength are greater than the length of array value, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 



6.1.5.3.1.3 



Context errors 



• CRRCl: if the HTTP header was already finalized, a uicc.scws.ScwsException with reason codes 
HEADER_ALREADY_FINALIZED is thrown. 

• CRRC2: if appending the header variable would cause an overflow of the response buffer, a 
uicc.scws.ScwsException with reason codes BUFFER_OVERFLOW is thrown. 

• CRRC3: if the flush method was called previously, a uicc.scws.ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC4: if the sendError method was called previously, a uicc.scws.ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.3.2 Test area files 

Specific triggering: None: 

Test Source: Test_Api_l_Hrs_Ahva_Bss_Bss .Java. 

Test Applet: Api_l_Hrs_Ahva_Bss_Bss _l.java. 

Cap File: Api_l_Hrs_Ahva_Bss_Bss .cap. 



6.1.5.3.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5 


N2 


1,2,3,4,5 


P1 


6 


P2 


7 


P3 


8 


P4 


10 


P5 


12 


P6 


9 


P7 


11 


P8 


13 


C1 


14, 15 


C2 


16 


C3 


17 


C4 


18 
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6.1.5.3.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


1 


Basic 

writeStatusCode (200) 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= 1, 
value= [B] , 
value Offset= 0, 
value Length= 1) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header { "A" )= "B" 

Header { " Content - Length " ) = " 2 " 

contentBody= "OK" 
) 


2 


nameOffset>0 

writeStatusCode (200) 

appendHeaderVariable { 
name= [XAa] , 
nameOffset= 1, 
nameLength= 2 , 
value= [B] , 
value Offset= 0, 
value Length= 1) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header { "Aa" ) = "B" 

Header { " Content - Length " ) = " 2 " 

contentBody= "OK" 
) 


3 


valueOffset>0 

writeStatusCode (200) 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= 1 , 
value= [XBb] , 
valueOffset= 1, 
valueLength= 2) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header { "A" )= "Bb" 

Header {"Content-Length" ) = "2" 

contentBody= "OK" 
) 


4 


nameLength = 

writeStatusCode (200) 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= , 
value= [B] , 
valueOffset= 0, 
valueLength= 1) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) 


When header name length is then 
nothing is append to the responseBuffer. 


HTTPResponse { 
statusCode= "200" 
Header { " Content - Length " ) = " 2 " 

contentBody= "OK" 
HeaderNotPresent { "A" ) 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


5 


valueLength = 

writeStatusCode (200) 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= 1, 
value= [B] , 
valueOffset= 0, 
valueLength= 0) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header {"Content-Length" ) = "2" 

Header { "A" )= "" 

contentBody= "OK" 
) 


6 


name[] is null 

appendHeaderVariable { 

name= null, 

nameOffset= 0, 

nameLength= 1, 

value= [B] , 

value Offset= 0, 
value Length= 1 
) 


Java . lang.NullPointerException is 

thrown. 

Catch the exception and build a page with 

status code = 204 


HTTPResponse { 

statusCode = "204" 
) 


7 


value[] is null 

appendHeaderVariable { 

name= [A] , 

nameOffset= 0, 

nameLength= 1 , 

value= null, 

value Offset= 0, 
value Length= 1) 


Java . lang.NullPointerException 
is thrown. 

Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


8 


nameOffset<0 

appendHeaderVariable { 
name= [A] , 
nameOffset= -1, 
nameLength= 1, 
value= [B] , 
valueOffset= 0, 
valueLength= 1) 


j ava . lang . ArraylndexOutOf BoundsE 
xception is thrown. 
Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


9 


valueOffset<0 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= 1 , 
value= [B] , 
valueOffset= -1, 
valueLength= 1) 


Java . lang. ArraylndexOutOf BoundsE 
xception is thrown. 
Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


10 


nameLength<0 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= -1, 
value= [B] , 
valueOffset= 0, 
valueLength= 1) 


j ava . lang . ArraylndexOutOf BoundsE 
xception is thrown. 
Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


11 


valueLength<0 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= 1, 
value= [B] , 
valueOffset= 0, 
valueLength= -1) 


Java . lang. ArraylndexOutOf BoundsE 
xception is thrown. 
Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


12 


nameOffset + nameLength > 
name.length 










appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 


j ava . lang . ArraylndexOutOf BoundsE 

xception is thrown. 

Catch the exception and build a page with 


HTTPResponse { 

statusCode = "204" 
) 






nameLength= 2 , 


status code = 204 








value= [B] , 










valueOffset= 0, 










valueLength= 1) 








13 


valueOffset + valueLength > 
value.length 










appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 


j ava . lang . ArraylndexOutOf BoundsE 

xception is thrown. 

Catch the exception and build a page with 


HTTPResponse { 

StatusCode = "204" 
) 






nameLength= 1, 


status code = 204 








value= [B] , 










valueOffset= 0, 










valueLength= 2) 








14 


finalizeHeader called previously 

writeStatusCode (200) 
appendHeaderVariable { 

name= [A] , 

nameOffset= 0, 

nameLength= 1 , 

value= [B] , 

valueOffset= 0, 

valueLength= 1) 
finalizeHeader { ) ; 




HTTPResponse { 
statusCode= "200" 
Header { "A" )= "B" 
Header { "Content-Length" ) = 


"2" 




appendHeaderVariable { ^ 






HeaderNotPresent {"C" ) 






name= [C] , 

nameOffset= 0, 

nameLength= 1, 

value= [D] , 

valueOffset= 0, 

valueLength= l) ^ 


> 


Uicc . sews . ScwsException with 
reason codes 
HEADER_ALREADY_FINALIZED iS thrOWn. 

Catch the exception and continue the 
procedure. 


contentBody= "OK" 
) 






appendContent { [OK] ,0,2) ; 










flush {) ; 








15 


appendContent called previously 

writeStatusCode (200) 
appendHeaderVariable { 

name= [A] , 

nameOffset= 0, 

nameLengtli= 1, 










value= [B] , 
valueOffset= 0, 
valueLength= 1) 
appendContent { [OK] ,0,2) ; 




HTTPResponse { 
statusCode= "200" 
Header { "A" )= "B" 
Header { " Content - Length " ) = 

HeaderNotPresent {"C" ) 
contentBody= "OK" 
) 


"2" 


appendHeaderVariable { ^ 
name= [C] , 
nameOffset= 0, 
nameLengtli= 1, 
value= [D] , 
valueOffset= 0, 


> 


uicc . sews . ScwsException with 
reason codes 
HEADER_ALREADY_FINALIZED is thrOWn. 

Catch the exception and continue the 




valueLengtli= 1) _, 




procedure. 








flush {) ; 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


16 


BUFFER_OVERFLOW 










writeStatusCode (200) 
appendHeaderVariable { 

name= [A] , 

nameOffset= 0, 

nameLength= 1 , 


uicc . sews . ScwsException with 
reason codes BUFFER_OVERFLOW iS 

thrown. 

Catch the exception and continue 


HTTPResponse { 
statusCode = "200" 
Header { "Content-Length" ) = 
HeaderNotPresent { "A" ) 


"0" 




value= [B] , 


the procedure. 








valueOffset= 0, 










valueLength= 










{remainingBuf f erLength+1) ) 








17 


flush called previously 

writeStatusCode (200) 
appendHeaderVariable { 

name= [A] , 

nameOffset= 0, 

nameLength= 1, 

value= [B] , 

valueOffset= 0, 

valueLength= 1) 




HTTPResponse { 
statusCode= "200" 
Header { "A" )= "B" 






appendContent { [OK] ,0,2) ; 




Header { "Content-Length") = 


"2" 




flush {) ; 




HeaderNotPresent {"C" ) 
contentBody= "OK" 






appendHeaderVariable { ^ 






) 






name= [C] , 




uicc . sews . ScwsException with 








nameOffset= 0, 




reason codes 








nameLength= 1, 


> 


HTTP RESPONSE ALREADY SENT iS 








value= [D] , 




thrown. 








valueOffset= 0, 

valueLength= 1) ^ 




Catch the exception and continue the 
procedure. 






18 


sendError called previously 

sendError (500) 










appendHeaderVariable { '^ 
name= [A] , 
nameOffset= 0, 
nameLength= 1, 
value= [B] , 
valueOffset= 0, 


> 


uicc. sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 


HTTPResponse { 
statusCode= "500" 
HeaderNotPresent { "A" ) 

) 






valueLength= 1) ^ 




procedure. 







6.1 .5.4 Method appendHeaderVariable (short headerKeywordNameld, byte[] value, 
short valueOffset, short valueLength) 

This test case is FFS. 

6.1 .5.5 Method enableChunkMode 

Test Area Reference: Api_l_Hrs_Encm. 

6.1.5.5.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void enableChunkMode { ) 

6.1 .5.5.1 .1 Normal execution 

• CRRNl: Informs the SCWS to use the chunked mode for sending the response. 

• CRRN2: Chunked mode off is the default mode. 

• CRRN3: This allows the SCWS to handle large amounts of response data. 
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6.1.5.5.1.2 
• n/a. 



Parameter Errors 



6.1.5.5.1.3 



Context errors 



• CRRCl: if the HTTP header was already finalized, a uicc.scws.ScwsException with reason codes 
HEADER_ALREADY_FINALIZED is thrown. 

• CRRC2: if the flush method was called previously, a uicc.scws.ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC3: if the sendError method was called previously, a uicc.scws.ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.5.2 Test area files 

Specific triggering: None: 



Test Source: 
Test Applet: 
Cap File: 

6.1.5.5.3 



Test_Api_ 1 _Hrs_Encm.j ava. 
Api_ 1 _Hrs_Encm_ 1 .j ava. 
Api_ 1 _Hrs_Encm. cap . 



Test coverage 



CRR number 


Test case number 


N1 


1, 2, 3, 11 


N2 


4 


N3 


5,6 


C1 


7,8 


02 


9 


03 


10 



6.1.5.5.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


1 


call in First 

enableChunkMode { ) 

writeStatusCode (200) 
appendHeaderVariable { 

headerKeywordNameId= 1, 

value= [headerlheader2] , 

valueOffset= 0, 

valueLength= 7) 
f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse ( 

statusCode= "200" 

Header ( "Accept" ) = "headerl" 

Header ( "Transfer -Encoding" ) = 
"chunked" 

contentBody= "OK" 
) 


2 


write StatusCode call before 

writeStatusCode (200) 
enableChunkMode { ) 

appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 
valueOffset= 0, 
valueLength= 7) 

f inalizeHeader { ) ; 

appendContent { [OK] ,0,2) ; 

flush {) ; 




HTTPResponse ( 

statusCode= "200" 

Header ( "Accept" ) = "headerl" 

Header ( "Transfer -Encoding" ) = 
"chunked" 

contentBody= "OK" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


3 


appendHeaderVarlable call befo 

writeStatusCode (200) 
appendHeaderVarlable { 


re 


HTTPResponse ( 




headerKeywordNameId= 1, 




statusCode= "200" 




value= [headerlheader2] , 




Header ( "Accept" ) = "headerl" 




valueOffset= 0, 




Header ( "Transfer -Encoding" ) = 




valueLength= 7) 




"chunked" 

contentBody= "OK" 




enableChunkMode { ) 




) 




f InallzeHeader { ) ; 








appendContent { [OK] ,0,2) ; 








flush {) ; 






4 


default mode off 




HTTPResponse ( 




writeStatusCode (200) 




statusCode= "200" 




appendHeaderVarlable { 




Header ( "Accept" ) = "headerl" 




headerKeywordNameId= 1, 




Content -Length: "2" 




value= [headerlheader2] , 




HeaderNotPresent ( "Transfer- 




valueOffset= 0, 




Encoding" ) 




valueLength= 7) 




contentBody= "OK" 




f InallzeHeader { ) ; 




\ 




appendContent { [OK] ,0,2) ; 




1 




flush {) ; 






5 


large data several append 

writeStatusCode (200) 
enableChunlcMode { ) 
f InallzeHeader { ) ; 








appendContent { [aaa. . 


.] , 0, 2048) 








appendContent { [aaa. . 
appendContent { [aaa. . 








2048) 
2048) 




HTTPResponse ( 
statusCode= "200" 




appendContent { [aaa. . 







2048) 




Header ( "Transfer -Encoding" ) = 




appendContent { [aaa. . 







2048) 




"chunked" 




appendContent { [aaa. . 







2048) 




contentBody= "aaa..." 




appendContent { [aaa. . 







2048) 




) 




appendContent { [aaa. . 







2048) 




1 




appendContent { [aaa. . 







2048) 








appendContent { [aaa. . 







2048) 








flush {) ; 






6 


large data one append 




HTTPResponse ( 




writeStatusCode (200) 




statusCode= "200" 

Header ( "Transfer -Encoding" ) = 




enableChunlcMode { ) 




"chunked" 

contentBody= "aaa. . . " 




f InallzeHeader { ) ; 




\ 




appendContent { [aaa. ..], 0, 10240 


; 


1 




flush {) ; 






7 


header already finalized 01 

writeStatusCode (200) 
appendHeaderVarlable { 
headerKeywordNameId= 1, 








value= [headerlheader2] , 




HTTPResponse ( 




valueOffset= 0, 




statusCode= "200" 




valueLength= 7) 




Header ( "Accept" ) = "headerl" 




f InallzeHeader { ) ; 




Header ( " Content- Length " ) = "2" 
HeaderNotPresent ( "Transfer- 




enableChunlcMode { ) ; 


"1 Ulcc . sews . ScwsExceptlon with 


Encoding" ) 






?■ reason codes 


contentBody= "OK" 






J HEADER_ALREADY_FINALIZED iS 


) 






thrown. 








Catch the exception and continue the 








procedure. 






appendContent { [OK] ,0,2) ; 








flush {) ; 
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Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


8 


header already finalized 02 

writeStatusCode (200) 
appendHeaderVariable { 
headerKeywordNameId= 1, 








value= [headerlheader2] , 




HTTPResponse ( 




valueOffset= 0, 




statusCode= "200" 




valueLength= 7) 




Header ( "Accept" ) = "headerl" 




f inalizeHeader { ) ; 




Header ( " Content- Length " ) = "2" 




appendContent { [OK] ,0,2) ; 




HeaderNotPresent ( "Transfer- 
Encoding" ) 




enableChunkMode { ) ; 


Uicc . sews . ScwsException with 
reason codes 
HEADER_ALREADY_FINALIZED iS 

thrown. 

Catch the exception and continue the 

procedure. 


contentBody= "OK" 
) 




flush {) ; 






9 


flush called previously 

writeStatusCode (200) 
appendHeaderVariable { 
headerKeywordNameId= 1, 








value= [headerlheader2] , 




HTTPResponse ( 




valueOffset= 0, 




statusCode= "200" 




valueLength= 7) 




Header ( "Accept" ) = "headerl" 




f inalizeHeader { ) ; 




Header ( " Content- Length " ) = "2" 




appendContent { [OK] ,0,2) ; 




HeaderNotPresent ( "Transfer- 




flush {) ; 




Encoding" ) 
contentBody= "OK" 




enableChunlcMode { ) ; "1 


uicc . sews . ScwsException with 
reason codes 

HTTP_RESPONSE_ALREADY_SENT is 
thrown . 

Catch the exception and continue the 
procedure. 


) 


10 


sendError called previously 

sendError (500) 








enableChunlcMode { ) ; "1 


uicc . sews . ScwsException with 
reason codes 

HTTP_RESPONSE_ALREADY_SENT is 
thrown . 

Catch the exception and continue the 
procedure. 


HTTPResponse ( 

statusCode= "500" 
) 


11 


Multiple success call 

enableChunlcMode { ) 
writeStatusCode (200) 








enableChunlcMode { ) 




HTTPResponse ( 




appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 
valueOffset= 0, 
valueLength= 7) 




statusCode= "200" 
Header ( "Accept ") = "headerl" 
Header ( "Transfer -Encoding" ) = 
"chunked" 

contentBody= "OK" 
) 




enableChunlcMode { ) 








enableChunlcMode { ) 








f inalizeHeader { ) ; 








appendContent { [OK] ,0,2) ; 








flush {) ; 
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6.1 .5.6 Method finalizeHeader 

Test Area Reference: Api_l_Hrs_Finh. 

6.1.5.6.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void finalizeHeader {) throws ScwsException 

6.1.5.6.1.1 Normal execution 

• CRRNl: Finalizes the header data in the outgoing buffer. It automatically adds missing header data with 
default values by the SCWS. 



6.1.5.6.1.2 
• n/a. 



Parameter Errors 



6.1.5.6.1.3 



Context errors 



• CRRCl : if the HTTP header was already finalized, a uicc. sews. ScwsException with reason codes 
HEADER. ALREADY_FINALIZED is thrown. 

• CRRC2: if the adding of missing header data would cause access outside the Response buffer, a 
uicc. sews. ScwsException with reason codes BUFFER_OVERFLOW is thrown. 

• CRRC3: if the flush method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC4: if the sendError method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.6.2 Test area files 

Specific triggering: None: 



Test Source: 
Test Applet: 
Cap File: 

6.1.5.6.3 



Test_Api_ 1 _Hrs_Finh.j ava. 
Api_ 1 _Hrs_Finh_ 1 . j a va . 
Api_l_Hrs_Finh.cap. 



Test coverage 



CRR number 


Test case number 


N1 


1 


C1 


5,6 


C2 


- 


C3 


7 


C4 


8 
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6.1.5.6.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


1 


Normal call 

writeStatusCode (200) 








appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 
valueOffset= 0, 
valueLength= 7) 




HTTPResponse { 
statusCode= "200" 
Header { "Accept" ) = "headerl" 
Header { "Content -Length" ) = "2" 
contentBody= "OK" 




f inalizeHeader { ) ; 




) 




appendContent { [OK] ,0,2) ; 








flush {) ; 






2 


lieader already finalized 01 

writeStatusCode (200) 

appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 








valueOffset= 0, 

valueLength= 7) 




HTTPResponse { 
statusCode= "200" 




f inalizeHeader { ) ; 




Header { "Accept" ) = "headerl" 
Header {"Content-Length" ) = "2" 




f inalizeHeader {) ; ~1 


Uicc . sews . ScwsException with 
reason codes 
HEADER_ALREADY_FINALIZED iS 

thrown. 

Catch the exception and continue the 

procedure. 


contentBody= "OK" 
) 




appendContent { [OK] ,0,2) ; 








flush {) ; 






3 


lieader already finalized 02 

writeStatusCode (200) 

appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 
valueOffset= 0, 








valueLength= 7) 




HTTPResponse { 
statusCode= "200" 




f inalizeHeader { ) ; 




Header { "Accept" ) = "headerl" 
Header { "Content-Length" ) = "2" 




appendContent { [OK] ,0,2) ; 




contentBody= "OK" 




f inalizeHeader { ) ; 


uicc . sews . ScwsException with 
reason codes 
HEADER_ALREADY_FINALIZED iS 

thrown. 

Catch the exception and continue the 

procedure. 


) 




flush {) ; 






4 


flush called previously 

writeStatusCode (200) 

appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 








valueOffset= 0, 




HTTPResponse { 




valueLength= 7 
) 




statusCode= "200" 

Header { "Accept" ) = "headerl" 




appendContent { [OK] ,0,2) ; 




Header {"Content-Length" ) = "2" 




flush {) ; 




contentBody= "OK" 




f inalizeHeader {) ; ~| 


uicc . sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


1 
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Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


5 


sendError called previously 

sendError (500) 

f inalizeHeader { ) ; "1 


Uicc. sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse { 

statusCode= "500" 
) 



6.1.5.7 Method flush 

Test Area Reference: Api_l_Hrs_Flus. 

6.1.5.7.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void flush {) 

6.1.5.7.1.1 Normal execution 

• CRRNl: Sends all data contained in the HTTP response. 

• CRRN2: If this method is invoked in fixed buffer mode after a previous invocation of the same method the 
sews will do nothing. 

• CRRN3: If this method is invoked in fixed buffer mode and the sendError() message was invoked previously 
the sews will do nothing. 

• CRRN4: Invoking this method for the first time implicitly finalizes the header of the HttpResponse. 

6.1 .5.7.1 .2 Parameter Errors 

• n/a. 



6.1.5.7.1.3 



Context errors 



• CRRCl : if the adding of missing header data would cause access outside the Response buffer, a 
uicc. sews. ScwsException with reason codes BUFFER_OVERFLOW is thrown. 

6.1.5.7.2 Test area files 

Specific triggering: None: 

Test Source: Test_Api_l_Hrs_Flus.java. 

Test Applet: Api_l_Hrs_Flus_l.java. 

Cap File: Api _l_Hrs_Flus.cap. 
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Test coverage 



CRR number 


Test case number 


N1 


1,2,3,5 


N2 


2 


N3 


6 


N4 


4 


C1 


- 



6.1.5.7.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


1 


Normal case + Chunk off 

writeStatusCode (200) 
f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 

flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header { " Content - Length " ) = " 2 " 

contentBody= "OK" 
) 


2 


Repeat flush + chunk off 

writeStatusCode (200) 
f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 

flush {) ; 
flush {) ; 
flush {) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header { " Content - Length " ) = " 2 " 

contentBody= "OK" 
) 


3 


Normal case + chunk on 

writeStatusCode (200) 
enableChunlcMode { ) ; 
f inalizeHeader { ) ; 
appendContent { [Hello] ,0,5) ; 

flush {) ; 

appendContent { [ ] , , 1) ; 

flush {) ; 

appendContent { [World] ,0,5) ; 

flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header { "Transfer-Encoding" ) = 
" chunk " 

contentBody= "Hello World" 
) 


4 


Finalized the http header 

writeStatusCode (200) ; 
flush {) ; 




HTTPResponse { 
statusCode= "200" 
Header { " Content - Length " ) = " " 

contentBody= " " 
) 


5 


No flush 

writeStatusCode (200) 
f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 




HTTPResponse { 

statusCode= "200" 

Header { " Content - Length " ) = " 2 " 

contentBody= "OK" 
) 


6 


SendError before 

sendError (500) ; 
flush {) ; 




HTTPResponse { 

statusCode= "500" 
) 



6.1.5.8 Method getRemainingResponseBufferSize 

Test Area Reference: Api_l_Hrs_Grrs. 
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6.1.5.8.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

int getRemainingResponseBuf f erSize { ) 

6.1 .5.8.1 .1 Normal execution 

• CRRNl: Returns the remaining size of the Response Buffer available for this applet. 

• CRRN2: The size returned by this method is guaranteed until the next header data is added to the Response 
Buffer. 

• CRRN3: The size returned by this method is guaranteed until the content data is added to the Response Buffer. 

• CRRN4: Returns -1 if chunked mode is switched on. 



6.1.5.8.1.2 


Parameter Err( 


• n/a. 




6.1.5.8.1.3 


Context errors 



• CRRCl: if the flush method was called previously and the selected transfer mode is "Fixed transfer mode", a 
uicc.scws.ScwsException with reason codes HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC2: if the sendError method was called previously and the selected transfer mode is "Fixed transfer 
mode", a uicc.scws.ScwsException with reason codes HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.8.2 Test area files 

Specific triggering: None: 



Test Source: 
Test Applet: 
Cap File: 

6.1.5.8.3 



Test_Api_ 1 _Hrs_Grrs .j ava. 
Api_l_Hrs_Grrs_l .Java. 
Api_l_Hrs_Grrs.cap. 



Test coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


3 


N3 


1 


N4 


2 


C1 


4 


C2 


5 
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6.1.5.8.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


1 


Remaining content data 

writeStatusCode {200) 
f inalizeHeader { ) 

remaining = 
getRemainingResponseBuf f erSize { ) ; 

appendContent { 

data = [aaa. . . ] 

offset = 

length = remaining 
) 
flush {) 




HTTPResponse { 

statusCode= "200" 

Header { "Content -Length" ) = 
remaining 

contentBody = "AaA [...]" 
) 


2 


Remaining + Chunk on 

writeStatusCode {200) 
enableChunkMode { ) ; 
f inalizeHeader { ) ; 

remaining = 
getRemainingResponseBuf ferSize {) ; 

appendContent { [OK] ,0,2) ; 
flush {) ; 


remaining = -1 


HTTPResponse { 

statusCode= "200" 

Header { "Transfer-Encoding" ) = 
"chunked" 

contentBody= "OK" 
) 


3 


Remaining header data 

writeStatusCode {200) 

remainingA = 
getRemainingResponseBuf ferSize { ) ; 

appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 
valueOffset= 7, 
valueLength= 7 

) 




HTTPResponse { 

statusCode= "200" 

Header {"Accept" ) = "header2" 

Header {"Content-Length" ) = "2" 

contentBody= "OK" 
) 


remainingB = 
getRemainingResponseBuf ferSize { ) ; 

remainingC = 
getRemainingResponseBuf ferSize { ) ; 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 


remainingB < remainingA 
remainingB = remainingC 


4 


flush called previously 

writeStatusCode {200) 
f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 

getRemainingResponseBuf ferSize { ) J] 


Uicc. sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse { 

statusCode= "200" 

Header { " Content - Length " ) = " 2 " 

contentBody= "OK" 
) 


5 


sendError called previously 

sendError {500) 
getRemainingResponseBuf ferSize {) ;~| 


uicc. sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse { 

statusCode= "500" 
) 
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6.1.5.9 Method reset 

Test Area Reference: Api_l_Hrs_Rset. 

6.1.5.9.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void reset {) throws ScwsException 

6.1.5.9.1.1 Normal execution 

• CRRNl: Clears the Response Buffer content. 

• CRRN2: Reset the state of the HttpResponse Object to its initial state. 

• CRRN3: All the header variables and content that was appended to the HttpResponse until the invocation 
of the reset method is lost. 



6.1.5.9.1.2 
• n/a. 



Parameter Errors 



6.1.5.9.1.3 



Context errors 



• CRRCl ; if the flush method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC2: if the sendError method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.9.2 Test area files 

Specific triggering: None: 



Test Source: 
Test Applet: 
Cap File: 

6.1.5.9.3 



Test_Api_ 1 _Hrs_Rset.j ava. 
Api_l_Hrs_Rset_l .Java. 
Api_ 1 _Hrs_Rset. cap. 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


1,2,3 


N3 


1,2,3 


C1 


6 


C2 


7 
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6.1.5.9.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


1 


Reset StatusCode 








writeStatusCode (204) 




HTTPResponse { 
statusCode= "200" 




reset { ) ; 




Header { " Content - Length" ) = " 2 " 

contentBody = "OK" 
) 


writeStatusCode (200) ; "1 




f inalizeHeader { ) ; J 






appendContent { [OK] , , 2 ) ; 








flush {) ; 






2 


Reset Header 

writeStatusCode (500) ; 








appendHeaderVariable {8 , [LI] 
, , 2 ) ; 




HTTPResponse { 
statusCode= 200 




reset { ) ; 




Header {"Content-Length" ) = "2" 






Header { " Content - Language " ) = " L2 " 




appendHeaderVariable {8 , [L2] 




contentBody = "OK" 

) 




, , 2 ) ; 




1 




appendContent { [OK] , , 2 ) ; 








flush {) ; 






3 


Reset ContentType 




HTTPResponse { 




setContentType (4) ; 
reset {) ; 




statusCode= "200" 

Header {"Content-Length") = "2" 






Header { " Content - Type " ) = 




writeStatusCode (200) ; 
appendContent { [OK] , , 2 ) ; 




"text/plain" [default value) . 
contentBody = "OK" 

) 




flush {) ; 






4 


Reset Header Finalized 

writeStatusCode (200) ; 
appendHeaderVariable {8 , [LI] 








, , 2 ) ; 




HTTPResponse { 




f inalizeHeader { ) ; 




statusCode= "200" 

Header { "Content-Length" )= "2" 




reset { ) ; 




Header { "Content-Language" )= "L2" 
contentBody = "OK" 




appendHeaderVariable {8 , [L2] 




) 




, , 2 ) ; 








appendContent { [OK] , , 2 ) ; 








flush {) ; 






5 


Reset Data 

writeStatusCode (200) ; 








appendHeaderVariable {8, [LI] 




HTTPResponse { 




, , 2 ) ; 




statusCode= "200" 




f inalizeHeader { ) ; 




Header {"Content-Length" ) = "2" 




appendContent { [NOT OK] , , 




HeaderNotPresent {"Content- 




S) ; 




Language" ) 

contentBody = "OK" 




reset {) ; 




) 




appendContent { [OK] , , 2 ) ; 








flush {) ; 






6 


flush() called previously 

writeStatusCode (200) ; 








f inalizeHeader { ) ; 




HTTPResponse { 




appendContent { [OK] , , 2 ) ; 




statusCode= "200" 




flush {) ; 




Header { " Content - Length " ) = " 2 " 

contentBody = "OK" 




reset { ) ; 1 


uicc . sews . ScwsException with reason 
codes HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the procedure. 


) 
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Test Case 



Description 



API/SCWS Frameworic Expectation 



APDU/HTTP Expectation 



sendError called previously 

sendError (500) ; 
reset { ) ; 



i: 



uicc . sews . ScwsException with reason 
codes HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the procedure. 



HTTPResponse { 
statusCode= "500" 



6.1 .5.1 Method sendError 

Test Area Reference: Api_l_Hrs_Sene. 

6.1.5.10.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void sendError {short errorCode) 

6.1.5.10.1.1 Normal execution 

• CRRN 1 : Sends an error code to the SC WS . 

• CRRN2: The HTTP response is sent immediately by the SCWS no other data is send by the SCWS. 

• CRRN3: Missing header variables are added by the SCWS with their default values. 

• CRRN4: Invoking this method implicitly finalizes the header of the HttpResponse. 

6.1.5.10.1.2 Parameter Errors 

• CRRPl : if parameter errorCode is unknown with respect to the HTTP 1 . 1 protocol , a 

uicc . SCWS . ScwsException with reason codes HTTP_CODE_UNKNOWN is thrown. 



6.1.5.10.1.3 



Context errors 



• CRRCl: if the HTTP header was already finalized, a uicc. sews. ScwsException with reason codes 
HEADER. ALREADY_FINALIZED is thrown. 

• CRRC2: if the flush method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC3: if the sendError method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.10.2 Test area files 

Specific triggering: None: 

Test Source: Test_Api_l_Hrs_Sene.java. 

Test Applet: Api_l_Hrs_Sene_l.java. 

Cap File: Api_l_Hrs_Sene.cap. 
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Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,6 


N2 


1,2,3,4,5,6 


N3 


1,2,3,4,5,6 


N4 


1,2,3,4,5,6 


P1 


7 


C1 


8,9 


C2 


10 


C3 


11 
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6.1.5.10.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


1 


Normal use case : Return an Informational code (1xx) 


a 


// SC_CONTINUE 
sendError (100) 




Not testable 


b 


// SC_SWITCHING_PROTOCOLS 
sendError (101) 




Not testable 


2 


Normal use case : Return a Successful code (2xx) 


a 


// SC_OK 
sendError (200) 




HTTPResponse ( 

statusCode= 2 00 
) 


b 


// SC_CREATED 
sendError (201) 




HTTPResponse ( 

statusCode= 201 
) 


c 


// SC^ACCEPTED 
sendError (202) 




HTTPResponse ( 

statusCode= 202 
) 


d 


// 

SC_NON_AUTHORITATIVE_INFORMATION 
sendError (203) 




HTTPResponse ( 

statusCode= 2 03 
) 


e 


// SC_NO_CONTENT 
sendError (204) 




HTTPResponse ( 

statusCode= 2 04 
) 


f 


// SC_RESET_CONTENT 
sendError (205) 




HTTPResponse ( 

statusCode= 205 
) 




// SC_PARTIAL_CONTENT 
sendError (206) 




HTTPResponse ( 

statusCode= 206 
) 


3 


Normal use case : Return a Redirection code (3xx) 


a 


// SC_MULTIPLE_CHOICES 
sendError (300) 




HTTPResponse ( 

statusCode= 300 
) 


b 


// SC_MOVED_PERMANENTLY 
sendError (301) 




HTTPResponse ( 

statusCode= 301 
) 


c 


// SC_FOUND 
sendError (302) 




HTTPResponse ( 

statusCode= 302 
) 


d 


// SC_SEE_OTHER 
sendError (303) 




HTTPResponse ( 

statusCode= 303 
) 


e 


// SC_NOT_MODIFIED 
sendError (304) 




HTTPResponse ( 

statusCode= 3 04 
) 


f 


// SC_USE_PROXY 
sendError (305) 




HTTPResponse ( 

statusCode= 305 
) 


g 


// SC_TEMPORARY_REDIRECT 
sendError (307) 




HTTPResponse ( 

statusCode= 307 
) 


4 


Normal use case : Return a client error code (4xx) 


a 


// SC_BAD_REQUEST 
sendError (400) 




HTTPResponse ( 

statusCode= 400 
) 


b 


// SC_UNAUTHORIZED 
sendError (401) 




HTTPResponse ( 

statusCode= 401 
) 


c 


// SC_PAYMENT_REQUIRED 
sendError (402) 




HTTPResponse ( 

statusCode= 402 
) 


d 


// SC_FORBIDDEN 
sendError (403) 




HTTPResponse ( 

statusCode= 403 
) 


e 


// SC_NOT_FOUND 
sendError (404) 




HTTPResponse ( 

statusCode= 404 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 




f 


// SC_METHOD_NOT_ALLOWED 
sendError (405) 




HTTPResponse ( 

statusCode= 405 
) 


g 


// SC_NOT_ACCEPTABLE 
sendError (406) 




HTTPResponse ( 

statusCode= 40G 
) 


h 


// 

SC_PROXY_AUTHENTICATION_REQUIRED 
sendError (407) 




HTTPResponse ( 

statusCode= 407 
) 


i 


// SC_REQUEST_TIMEOUT 
sendError (408) 




HTTPResponse ( 

statusCode= 408 
) 


J 


// SC_CONFLICT 
sendError (409) 




HTTPResponse ( 

statusCode= 409 
) 


k 


// SC_GONE 
sendError (410) 




HTTPResponse ( 

statusCode= 410 
) 


1 


// SC_LENGTH_REQUIRED 
sendError (411) 




HTTPResponse ( 

statusCode= 411 
) 


m 


// SC_PRECONDITION_FAILED 
sendError (412) 




HTTPResponse ( 

statusCode= 412 
) 


n 


// SC_REQUEST_ENTITY_TOO_LARGE 
sendError (413) 




HTTPResponse ( 

statusCode= 413 
) 





// SC_REQUEST_URI_TOO_LONG 
sendError (414) 




HTTPResponse ( 

statusCode= 414 
) 


P 


// SC_UNSUPPORTED_MEDIA_TYPE 
sendError (415) 




HTTPResponse ( 

statusCode= 415 
) 


q 


// 

SC_REQUESTED_RANGE_NOT_SATISFIABLE 
sendError (416) 




HTTPResponse ( 

statusCode= 41S 
) 


r 


// SC_EXPECTATION_FAILED 
sendError (417) 




HTTPResponse ( 

statusCode= 417 
) 


5 


Normal use case : Return a Server Error 5xx code 


a 


// SC_INTERNAL_SERVER_ERRGR 
sendError (500) 




HTTPResponse ( 

statusCode= 500 
) 


b 


// SC_NOT_IMPLEMENTED 
sendError (501) 




HTTPResponse ( 

statusCode= 501 
) 


c 


// SC_BAD_GATEWAY 
sendError (502) 




HTTPResponse ( 

statusCode= 502 
) 


d 


// SC_SERVICE_IINAVAILABLE 
sendError (503) 




HTTPResponse ( 

statusCode= 503 
) 


e 


// SC_GATEWAY_TIMEOUT 
sendError (504) 




HTTPResponse ( 

statusCode= 504 
) 


f 


// SC_HTTP_VERSION_NOT_SUPPORTED 
sendError (505) 




HTTPResponse ( 

statusCode= 505 
) 


6 


After writeStatusCode 

writeStatusCode (200) ; 
sendError (403) ; 




HTTPResponse ( 

statusCode= 403 
) 


7 


HTTP_CODE_UNKNOWN 

sendError (0) 
sendError (-1) 
sendError (1000) 
sendError (99) 
sendError (102) 
sendError (199) 
sendError (207) 


uicc. sews . ScwsException with 
reason codes 
HTTP_CODE_DNKNOW iS thrOWn. 
Catch the exception and 
build a page with status 
code =2 04 


HTTPResponse ( 

statusCode = "204" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 




sendError (299) 










sendError (308) 










sendError (399) 










sendError (418) 










sendError (499) 










sendError (506) 










sendError (600) 










sendError (700) 










sendError (800) 










sendError (900) 








8 


finalizeHeader called previously 

writeStatusCode (200) 
finalizeHeader { ) ; 




HTTPResponse ( 






sendError (4 03) ; 


Uicc. sews . ScwsException witli 


statusCode= 200 






„ 


reason codes 


Header ( "Content -Length" ) = 


'2" 






HEADER_ALREADY_FINALIZED iS 


contentBody= "OK" 








thrown. 


) 








Catch the exception and continue the 










procedure. 








appendContent { [OK] ,0,2) ; 










flush {) ; 








9 


appendContent called previously 

writeStatusCode (200) 
appendContent { [OK] ,0,2) ; 




HTTPResponse ( 






sendError (4 03) ; 


uicc. sews . ScwsException witli 


statusCode= 200 






■ 


reason codes 


Header ( "Content -Length" ) = 


'2" 






HEADER_ALREADY_FINALIZED iS 


contentBody= "OK" 








thrown. 


) 








Catch the exception and continue the 










procedure. 








flusliO ; 








10 


flush called previously 

writeStatusCode (200) 
appendContent { [OK] ,0,2) ; 
flusliO ; 




HTTPResponse ( 
statusCode= 200 
Header ( "Content -Length" ) = 


'2" 




sendError (403) ; 


uicc . sews . ScwsException witli 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


contentBody= "OK" 
) 




11 


sendError called previously 

sendError (500) ; 




HTTPResponse ( 






sendError (4 03) ; 


uicc . sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


statusCode= 500 
) 





6.1.5.11 Method setContentType 

Test Area Reference: Api_l_Hrs_Scot. 
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6.1 .5.11 .1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void setContentType {short type) throws ScwsException 

6.1.5.11.1.1 Normal execution 

• CRRNl : Sets the content type of the HTTP response. 

6.1.5.11.1.2 Parameter Errors 

• CRRPl: if parameter type is not correct according to SCWSConstants, a 

uicc . sews . ScwsException with reason codes UNKNOWN_KEYWORD_ID is thrown. 



6.1.5.11.1.3 



Context errors 



• CRRCl: if the HTTP header was already finalized, a uicc. sews. ScwsException with reason codes 
HEADER_ALREADY_FINALIZED is thrown. 

• CRRC2: if appending the header variable would cause an overflow of the response buffer, a 
uicc. sews. ScwsException with reason codes BUFFER_OVERFLOW is thrown. 

• CRRC3: if the flush method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC4: if the sendError method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.11.2 Test area files 

Specific triggering: None: 

Test Source: Test_Api_l_Hrs_Scot.java. 

Test Applet: Api_l_Hrs_Scot_l.java. 

Cap File: Api_l_Hrs_Scot.cap. 



6.1.5.11.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5 


P1 


6 


01 


7,8 


C2 


- 


03 


9 


04 


10 



6.1.5.11.4 



Test procedure 



Test Case | 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


1 


All success type 


a 


// CONTENT_TYPE_IMAGE_GIF 
writeStatusCode (200) 
setContentType (4) ; 
final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 




HTTPResponse ( 

statusCode= "200" 

Header ( "Content -Type" ) = "image/gif" 

Header ( "Content -Length" ) = "2" 

contentBody= "OK" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 




b 


// CONTENT_TYPE_IMAGE_JPEG 
writeStatusCode (200) 
setContentType (3) ; 
final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 




HTTPResponse ( 

statusCode= 200 

Header ( "Content -Type" ) = "image/jpeg" 

Header ( " Content- Length " ) = "2" 

contentBody= "OK" 
) 


c 


// CONTENT_TYPE_IMAGE_PNG 
writeStatusCode (200) 
setContentType (5) ; 
final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 




HTTPResponse ( 

statusCode= 200 

Header ( "Content -Type" ) = "image/png" 

Header ( "Content -Length" ) = "2 " 

contentBody= "OK" 
) 


d 


// CONTENT_TYPE_TEXT_HTML 
writeStatusCode (200) 
setContentType (1) ; 
final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 




HTTPResponse ( 

statusCode= 200 

Header ( "Content -Type" ) = "text/html" 

Header ( "Content -Length" ) = "2 " 

contentBody= "OK" 
) 


e 


// CONTENT_TYPE_TEXT_PLAIN 
writeStatusCode (200) 
setContentType (2) ; 
final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 




HTTPResponse ( 
statusCode= 200 

Header ( "Content -Type" ) = "text/plain" 
Header ( "Content -Length" ) = "2" 

contentBody= "OK" 
) 


2 


Call in first 

setContentType (2) ; 

writeStatusCode (200) 
final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 




HTTPResponse ( 

statusCode= 200 

Header ( "Content -Type" ) = "text/plain" 

Header ( "Content -Length" ) = "2 " 

contentBody= "OK" 
) 


3 


Call after status line 

writeStatusCode (200) 

setContentType (2) ; 

final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 




HTTPResponse ( 

statusCode= 200 

Header ( "Content -Type" ) = "text/plain" 

Header ( "Content -Length" ) = "2 " 

contentBody= "OK" 
) 


4 


Call after appendHeaderVariable 

writeStatusCode (200) 

appendHeaderVariable ( 
headerKeywordNameId= 1, 
value= [header lheader2] , 
valueOffset= 0, 

valueLength= v) 

setContentType (2) ; 

final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 




HTTPResponse ( 
statusCode= 200 
Header ( "Accept" ) = "headerl" 
Header ( "Content -Type" ) = "text/plain" 
Header ( "Content -Length" ) = "2" 
contentBody= "OK" 

) 


5 


Multiple 

writeStatusCode (2( 

setContentType (5) 
setContentType (4) 
setContentType ( 3 ) 
setContentType ( 2 ) 
setContentType ( 1 ) 

final izeHeader ( ) ; 
appendContent ( [Ok; 


call 

JO) 
,0,2) ; 




HTTPResponse ( 

statusCode= 200 

Header ("Content-Type" )= "text/html" 

Header ( "Content -Length" ) = "2 " 

contentBody= "OK" 
) 
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Test Case 


Id 


Description 




API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 




flush ; 






6 


UNKNOWNKEYWORDID 

writeStatusCode (200) 










se t Content Type (0) ; 


*" 


uicc . sews .ScwsException with 








reason codes 










UNKNOWN_KEYWORD_ID iS thrOWn. 






setContentType ( -1) ; 


- 


uicc . sews . ScwsException with 








reason codes 








} 


UNKNOWN_KEYWORD_ID iS thrOWn. 






set Content Type (6) ; 


uicc . sews .ScwsException with 








reason codes 










UNKNOWN_KEYWORD_ID iS thrOWn. 






setContentType (-2) ; 


} 


uicc . sews . ScwsException with 
reason codes 
UNKNOWNKEYWORDID iS thrOWn. 

Catch all exceptions and continue the 
procedure. 


HTTPResponse ( 

statusCode= 200 

Header ( "Content -Type" ) = "text/plain" 

Header ( "Content -Length" ) = "2 " 

contentBody= "OK" 
) 




setContentType (2) ; 










final izeHeader ( ) ; 










appendContent ( [OK] ,0,2) ; 










flush ; 








7 


finalizeHeader called previously 








writeStatusCode (200) 










final izeHeader ( ) ; 










setContentType (2) ; 


"1 


uicc . sews . ScwsException with 


HTTPResponse ( 






reason codes 


statusCode= 200 








HEADER_ALREADY_FINALIZED iS 


Header ( "Content -Length" ) = "2 " 








thrown. 


contentBody= "OK" 








Catch the exception and continue the 


) 








procedure. 






appendContent ( [OK] ,0,2) ; 










flush ; 








8 


appendContent called previously 








writeStatusCode (200) 










final izeHeader ( ) ; 










appendContent ( [OK] ,0,2) ; 






HTTPResponse ( 




setContentType (2) ; 


J 


uicc . sews . ScwsException with 
reason codes 
HEADER_ALREADY_FINALIZED iS 

thrown. 

Catch the exception and continue the 

procedure. 


statusCode= 200 
Header ( "Content -Length" ) = "2 " 
contentBody= "OK" 
) 




flush ; 








9 


flush called previously 

writeStatusCode (200) 
setContentType (2) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 






HTTPResponse ( 
statusCode= 200 








Header ( "Content -Type" ) = "text/plain 




setContentType (1) ; 


-J 


uicc . sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


Header ( " Content- Length " ) = "2" 
contentBody= "OK" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


10 


sendError called previously 

sendError (500) 










setContentType (2) ; 


-" 


ulcc . sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse ( 

statusCode= 500 
) 



6.1.5.12 Method writeStatusCode 

Test Area Reference: Api_l_Hrs_Wstc. 

6.1.5.12.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void writeStatusCode {short code) 

throws ScwsException 

6.1.5.12.1.1 Normal execution 

• CRRNl: Write an HTTP status code into the outgoing buffer. 



6.1.5.12.1.2 



Parameter Errors 



CRRPl: if parameter code is unknown with respect to the HTTP 1.1 protocol , a 

uicc . sews . ScwsException with reason codes HTTP_CODE_UNKNOWN is thrown. 



6.1.5.12.1.3 



Context errors 



• CRRCl: if the HTTP header was already finalized, a uicc. sews. ScwsException with reason codes 
HEADER_ALREADY_F1NALIZED is thrown. 

• CRRC2: if the writeStatusCode has already been invoked, a uicc. sews. ScwsException with reason codes 
STATUS_LINE_ALREADY_SET is thrown. 

• CRRC3: if the appendHeaderVariable has already been invoked, a uicc. sews. ScwsException with reason 
codes STATUS_LINE_ALREADY_SET is thrown. 

• CRRC4: if the flush method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC5: if the sendError method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.12.2 Test area files 

Specific triggering: None: 

Test Source: Test_Api_l_Hrs_Wstc.java. 

Test Applet: Api_l_Hrs_Wstc_l.java. 

Cap File: Api_l_Hrs_Wstc.cap. 



£75/ 



(Release 7) 
6.1.5.12.3 



69 



Test coverage 



ETSI TS 102 835 V7.0.0 (2010-04) 



CRR number 


Test case number 


N1 


1,2,3,4,5, 12 


P1 


6 


C1 


7 


C2 


8 


C3 


9 


C4 


10 


C5 


11 



6.1.5.12.4 



Test procedure 



Test Case 



Id 



Description 



API/SCWS Framework 
Expectation 



APDU/HTTP Expectation 



Normal use case : Return a basic page with an Informational status code (Ixx) 



// SC_CONTINUE 
writeStatusCode (100) 



Not testable 



// SC_SWITCHING_PROTOCOLS 
writeStatusCode (101) 



Not testable 



Normal use case : Return a basic page with a Successful status code (2xx) 



// SC_OK 

writeStatusCode (200) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody 

) 



200 

ent-Length" ) = 2 
"OK" 



// SC_CREATED 
writeStatusCode (201) 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody 

) 



201 

ent-Length") = 2 
"OK" 



// SC_ACCEPTED 
writeStatusCode (202) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody 

) 



202 

ent-Length" ) = 2 
OK" 



HTTPResponse ( 
statusCode= 
Header { "Cont 
contentBody 

) 



// SC_NON_AUTHORITATIVE_INFORMATION 
writeStatusCode (203) 
appendContent ( [OK] ,0,2) ; 
flush ; 



203 

ent-Length") = 2 
"OK" 



// SC_NO_CONTENT 
writeStatusCode (204) 



HTTPResponse ( 
statusCode= 
Header ("Cont 

null // not p 

response . 

) 



204 

ent-Length" ) = 
resent in the 



// SC_RESET_CONTENT 
writeStatusCode (205) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody 

) 



205 

ent-Length") = 2 
"OK" 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody= 

) 



// SC_PARTIAL_CONTENT 
writeStatusCode (206) 
appendContent ( [OK] ,0,2) 
flush ; 



206 

ent-Length" ) = 2 
"OK" 



Normal use case : Return a basic page with a Redirection status code (Sxx) 



// SC_MULTIPLE_CHOICES 
writeStatusCode (300) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse ( 

statusCode= 300 

Header ( "Content-Length" ) : 

contentBody= "OK" 
) 



// SC_MOVED_PERMANENTLY 
writeStatusCode (301) 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse { 
statusCode= 3 01 
Header ("Content-Length") ■- 
contentBody= "OK" 

) 
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Test Case 



Id 



Description 



API/SCWS Framework 
Expectation 



APDU/HTTP Expectation 



// SC_FOUND 
writeStatusCode (302) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 

statusCode= 302 

Header {"Content-Length") ■- 

contentBody= "OK" 
) 



// SC_SEE_OTHER 
writeStatusCode (303) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse ( 

statusCode= 303 

Header ("Content-Length") = 

contentBody= "OK" 
) 



// SC_NOT_MODIFIED 
writeStatusCode (304) 



HTTPResponse { 
statusCode= 3 04 

) 



// SC_USE_PROXY 
writeStatusCode (305) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 

statusCode= 305 

Header { "Content-Length" ) : 

contentBody= "OK" 
) 



// SC_TEMPORARY_REDIRECT 
writeStatusCode (307) 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse { 

statusCode= 307 

Header { "Content-Length" 

contentBody= "OK" 
) 



Normal use case : Return a basic page with a Client error status code (4xx) 



// SC_BAD_REQUEST 
writeStatusCode (400) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody 

) 



400 

ent-Length" ) = 2 
"OK" 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody= 

) 



// SC_UNAUTHORIZED 
writeStatusCode (401) 
appendContent ( [OK] ,0,2) 
flush ; 



401 

ent-Length") = 2 
"OK" 



// SC_PAYMENT_REQUIRED 
writeStatusCode (402) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody 

) 



402 

ent-Length" ) = 2 
OK" 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody= 

) 



// SC^FORBIDDEN 
writeStatusCode (403) 
appendContent ( [OK] ,0,2) 
flush ; 



403 

ent-Length") = 2 
"OK" 



// SC_NOT_FOUND 
writeStatusCode (404) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 
statusCode= 
Header {"Cont 
contentBody 

) 



404 
ent-Length" ) = 2 



HTTPResponse { 
statusCode= 
Header {"Cont 
contentBody 

) 



// SC_METHOD_NOT_ALLOWED 
writeStatusCode (405) 
appendContent ( [OK] ,0,2) ; 
flush ; 



405 

ent-Length" ) = 2 
"OK" 



// SC_NOT_ACCEPTABLE 
writeStatusCode (406) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 
statusCode= 
Header {"Cont 
contentBody 

) 



406 

ent-Length" ) = 2 
"OK" 



/ / SC_PROXY_AUTHENTICATION_REQUIRED 
writeStatusCode (407) 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse { 
statusCode= 
Header {"Cont 
contentBody 

) 



407 

ent-Length" ) = 2 
"OK" 



// SC_REQUEST_TIMEOUT 
writeStatusCode (408) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 
statusCode= 
Header {"Cont 
contentBody 

) 



408 

ent-Length") = 2 
OK" 
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Test Case 



Id 



Description 



API/SCWS Framework 
Expectation 



APDU/HTTP Expectation 



// SC_CONFLICT 
writeStatusCode (409) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 
statusCode= 
Header {"Cont 
contentBody 

) 



409 

ent-Length" ) = 2 
"OK" 



HTTPResponse { 
statusCode= 
Header {"Cont 
contentBody= 

) 



// SC^GONE 
writeStatusCode (410) 
appendContent ( [OK] ,0,2) 
flush ; 



410 

ent-Length") = 2 
"OK" 



// SC_LENGTH_REQUIRED 
writeStatusCode (411) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody 

) 



411 

ent-Length" ) = 2 
"OK" 



HTTPResponse { 
statusCode= 
Header { "Cont 
contentBody= 

) 



m 



// SC_PRECONDITION_FAILED 
writeStatusCode (412) 
appendContent ( [OK] ,0,2) ; 
flush ; 



412 

ent-Length") = 2 
"OK" 



// SC_REQUEST_ENTITY_TOO_LARGE 
writeStatusCode (413) 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody 

) 



413 

ent-Length") = 2 
OK" 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody= 

) 



// SC_REQUEST_URI_TOO_LONG 
writeStatusCode (414) 
appendContent ( [OK] ,0,2) ; 
flush ; 



414 

ent-Length" ) = 2 
"OK" 



// SC_DNSUPPORTED_MEDIA_ 
writeStatusCode (415) 
appendContent ( [OK] ,0,2) ; 
flush ; 



TYPE 



HTTPResponse ( 
statusCode= 
Header ( "Cont 
contentBody 

) 



415 

ent-Length" ) = 2 
OK" 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody= 

) 



// SC_REQUESTED_RANGE_NOT_SATISFIABLE 
writeStatusCode (416) 
appendContent ( [OK] ,0,2) ; 
flush ; 



41S 

ent-Length" ) = 2 
"OK" 



// SC_EXPECTATION_FAILED 
writeStatusCode (417) 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody 

) 



417 

ent-Length" ) = 2 
OK" 



Normal use case : Return a basic page with a Server error status code (5xx) 



// SC_INTERNAL_SERVER_ERROR 
writeStatusCode (500) 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse { 

statusCode= 500 

Header ("Content-Length") ■- 

contentBody= "OK" 
) 



// SC_NOT_IMPLEMENTED 
writeStatusCode (501) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 

statusCode= 501 

Header ("Content-Length") ^ 

contentBody= "OK" 
) 



// SC_BAD_GATEWAY 
writeStatusCode (502) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 

statusCode= 502 

Header ("Content-Length") ^ 

contentBody= "OK" 
) 



// SC_SERVICE_DNAVAILABLE 
writeStatusCode (503) 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse { 

statusCode= 503 

Header ("Content-Length") ■- 

contentBody= "OK" 
) 



// SC_GATEWAY_TIMEOUT 
writeStatusCode (504) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 

statusCode= 504 

Header ("Content-Length") = 

contentBody= "OK" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 






f 


// SC_HTTP_VERSION_NOT_SUPPORTED 
writeStatusCode (505) 




HTTPResponse ( 
statusCode= 505 








appendContent ( [OK] ,0,2) ; 




Header ( "Content-Length" ) = 


2 






flush ; 




contentBody= "OK" 
) 




6 


HTTP_CODE_UNKNOWN 

writeStatusCode (0) 
writeStatusCode (-1) 
writeStatusCode (1000) 
writeStatusCode (99) 
writeStatusCode (102) 
writeStatusCode (199) 


uicc . sews . ScwsException 
with reason codes 








writeStatusCode (207) 


HTTP_CODE_UIINKNOW is 


HTTPResponse ( 






writeStatusCode (299) 


thrown . 


statusCode = "204" 






writeStatusCode (308) 


Catch ALL exceptions and 


) 






writeStatusCode (399) 


build a page with status 








writeStatusCode (418) 


code =2 04 








writeStatusCode (499) 










writeStatusCode (506) 










writeStatusCode (600) 










writeStatusCode (700) 










writeStatusCode (800) 










writeStatusCode (900) 








7 


header already finalized 

writeStatusCode (200) 
final izeHeader ( ) ; 










writeStatusCode (500) 


Uicc . sews . ScwsException 
with reason codes 


HTTPResponse ( 
statusCode= 200 








HEADER_ALREADY_FINALIZED iS 


Header ( "Content-Length" ) = 


2 






thrown. 


contentBody= "OK" 








Catch the exception and continue 


) 








the procedure. 








appendContent ( [OK] ,0,2) ; 










flush ; 








8 


writeStatusCode already invoked 

writeStatusCode (200) 
writeStatusCode (500) 


uicc . sews . ScwsException 
with reason codes 
STATUS_LINE_ALREADY_SET iS 


HTTPResponse ( 
statusCode= 200 








thrown. 


Header ( "Content-Length" ) = 


2 






Catch the exception and continue 


contentBody= "OK" 








the procedure. 


) 






final izeHeader ; 










appendContent ( [OK] ,0,2) ; 










flush ; 
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Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


9 


append hHeaderVariable already invoked 

writeStatusCode (200) 
appendHeaderVariable ( 

headerKeywordNameId= 10, 

value= [test] , 

valueOffset= 0, 

valueLength= 4 
) 

writeStatusCode (500) 

f inalizeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 


Uicc . sews . ScwsException 
with reason codes 
STATUS_LINE_ALREADY_SET iS 

thrown. 

Catch the exception and continue 

the procedure. 


HTTPResponse ( 
statusCode= 200 
Content-Length: 2 
Content-Type: test 
contentBody= "OK" 

) 


10 


flush called previously 

writeStatusCode (200) 
f inalizeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 

writeStatusCode (500) 


uicc . sews . ScwsException 
with reason codes 
HTTP_RESPONSE_ALREADY_SENT 

is thrown. 

Catch the exception and continue 

the procedure. 


HTTPResponse ( 
statusCode= 200 
Content-Length: 2 
contentBody= "OK" 

) 


11 
12 


sendError called previously 

sendError (500) 
writeStatusCode (200) 

writeStatusCode not called 

appendContent ( [OK] ,0,2) ; 
flush ( ) ; 


uicc . sews . ScwsException 
with reason codes 
HTTP_RESPONSE_ALREADY_SENT 

is thrown. 

Catch the exception and continue 

the procedure. 

Default status code is 200 . 


HTTPResponse ( 

statusCode= 500 
) 

HTTPResponse ( 
statusCode= 200 
Content-Length: 2 
contentBody= "OK" 

) 



6.2 sews Runtime Environment 

6.2.1 Applet state 

6.2.1 .1 Invokation of applets not in state selectable 

Test Area Reference: Api_2_Aps_Ivns. 

6.2.1 .1 .1 Conformance Requirement 

The sews Framework implementation shall be compliant to the following statement (TS 102 588 [2], clause 4.3): 
• Only an Applet that is in selectable state can be invoked by the SCWS. 
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6.2.1.1.1.1 Normal execution 

• CRRNl : Only an applet in selectable state can be invoked by the SCWS. 

• CRRN2 : If the applet is in non selectable state, then the SCWS does not invoke this one and returns an HTTP 
response with a error status code = SC_NOT_FOUND whatever the HTTP method. 



6.2.1.1.1.2 


Parameter Err( 


• n/a. 




6.2.1.1.1.3 


Context errors 


• n/a. 





6.2.1.1.2 Test area files 

Specific triggering: Unrecognized envelope: 

Test Source: Test_Api_2_Aps_Ivns.java. 

Test Applet: Api_2_Aps_Ivns_l.java. 

Cap File: Api_2_Aps_Ivns.cap. 



6.2.1.1.3 



Test coverage 



CRR number 


Test case number 


N1, N2 


1 


N1, N2 


2 


N1, N2 


3 


N1, N2 


4 


N1, N2 


5 


N1, N2 


6 


N1, N2 


7 



6.2.1.1.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 


1 


Invoke an applet LOCKED / UNLOCKED with HTTP methods: POST 

1 . Send POST HTTP REQUEST (1 ) to Api_2_Aps_lvns_1 

2. Lock the applet Api_2_Aps_lvns_1 (non selectable state) 

3. Send POST HTTP REQUEST (2) to Api_2_Aps_lvns_1 

4. Unlock the applet Api_2_Aps_lvns_1 (selectable state) 

5. Send POST HTTP REQUEST (3) to Api_2_Aps_lvns_1 

Applet source code in doPostO 




Check the HTTP 
RESPONSE (1): 

HTTPResponse { 

statusCode = 
"204" 

) 

RESPONSE (2): 

HTTPResponse { 

StatusCode = 
"404" 
) 

RESPONSE (3): 

HTTPResponse { 

StatusCode = 
"204" 
) 


response. writeStatusCode (ScwsConstants . SC_NO_CONTENT) ; 
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Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 


2 


Invoke an applet LOCKED / UNLOCKED with HTTP methods: GET 

1 . Send GET HTTP REQUEST (1 ) to Api_2_Aps_lvns_1 

2. Lock the applet Api_2_Aps_lvns_1 (non selectable state) 

3. Send GET HTTP REQUEST (2) to Api_2_Aps_lvns_1 

4. Unlock the applet Api_2_Aps_lvns_1 (selectable state) 

5. Send GET H 1 1 P REQUEST (3) to Api_2_Aps_lvns_1 

Applet source code in doGetO 




Check the HTTP 
RESPONSE (1): 

HTTPResponse ( 

statusCode = 
"204" 
) 

RESPONSE (2): 

HTTPResponse ( 

StatusCode = 
"404" 
) 

RESPONSE (3): 

HTTPResponse ( 

StatusCode = 
"204" 
) 


response. writeStatusCode (ScwsConstants . SC_NO_CONTENT) ; 


3 


Invoke an applet LOCKED / UNLOCKED with HTTP methods: DELETE 

1 . Send DELETE HTTP REQUEST (1) to Api_2_Aps_lvns_1 

2. Lock the applet Api_2_Aps_lvns_1 (non selectable state) 

3. Send DELETE HTTP REQUEST (2) to Api_2_Aps_lvns_1 

4. Unlock the applet Api_2_Aps_lvns_1 (selectable state) 

5. Send DELETE HTTP REQUEST (3) to Api_2_Aps_lvns_1 

Applet source code in doDeleteO 




Check the HTTP 
RESPONSE (1): 

HTTPResponse ( 

StatusCode = 
"204" 
) 

RESPONSE (2): 

HTTPResponse ( 

StatusCode = 
"404" 
) 

RESPONSE (3): 

HTTPResponse ( 

StatusCode = 
"204" 
) 


response. writeStatusCode (ScwsConstants . SC_NO_CONTENT) ; 


4 


Invoke an applet LOCKED / UNLOCKED with HTTP methods : HEAD 

1 . Send HEAD H II H REQUEST (1) to Api_2_Aps_lvns_1 

2. Lock the applet Api_2_Aps_lvns_1 (non selectable state) 

3. Send HEAD HTTP REQUEST (2) to Api_2_Aps_lvns_1 

4. Unlock the applet Api_2_Aps_lvns_1 (selectable state) 

5. Send HEAD HTTP REQUEST (3) to Api_2_Aps_lvns_1 

Applet source code in doHeadO 




Check the HTTP 
RESPONSE (1): 

HTTPResponse ( 

StatusCode = 
"204" 
) 

RESPONSE (2): 

HTTPResponse ( 

StatusCode = 
"404" 
) 

RESPONSE (3): 

HTTPResponse ( 

StatusCode = 
"204" 
) 


response. writeStatusCode (ScwsConstants . SC_NO_CONTENT) ; 
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Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 


5 


Invoke an applet LOCKED / UNLOCKED with HTTP methods : PUT 

1 . Send PUT HTTP REQUEST (1 ) to Api_2_Aps_lvns_1 

2. Lock the applet Api_2_Aps_lvns_1 (non selectable state) 

3. Send PUT HTTP REQUEST (2) to Api_2_Aps_lvns_1 

4. Unlock the applet Api_2_Aps_lvns_1 (selectable state) 

5. Send PUT HTTP REQUEST (3) to Api_2_Aps_lvns_1 

Applet source code in doPutO 




Check the HTTP 
RESPONSE (1): 

HTTPResponse { 

statusCode = 
"204" 
) 

RESPONSE (2): 

HTTPResponse { 

StatusCode = 
"404" 
) 

RESPONSE (3): 

HTTPResponse { 

StatusCode = 
"204" 
) 


response. writeStatusCode (ScwsConstants . SC_NO_CONTENT) ; 


6 


Invoke an applet LOCKED / UNLOCKED with HTTP methods : OPTIONS 

1 . Send OPTIONS HTTP REQUEST (1 ) to Api_2_Aps_lvns_1 

2. Lock the applet Api_2_Aps_lvns_1 (non selectable state) 

3. Send OPTIONS HTTP REQUEST (2) to Api_2_Aps_lvns_1 

4. Unlock the applet Api_2_Aps_lvns_1 (selectable state) 

5. Send OPTIONS HTTP REQUEST (3) to Api_2_Aps_lvns_1 

Applet source code in doOptionsO 




Check the HTTP 
RESPONSE (1): 

HTTPResponse { 

StatusCode = 
"204" 
) 

RESPONSE (2): 

HTTPResponse { 

StatusCode = 
"404" 
) 

RESPONSE (3): 

HTTPResponse { 

StatusCode = 
"204" 
) 


response. writeStatusCode (ScwsConstants . SC_NO_CONTENT) ; 


7 


Invoke an applet LOCKED / UNLOCKED with HTTP methods : TRACE 

1 . Send TRACE HTTP REQUEST (1) to Api_2_Aps_lvns_1 

2. Lock the applet Api_2_Aps_lvns_1 (non selectable state) 

3. Send TRACE HTTP REQUEST (2) to Api_2_Aps_lvns_1 

4. Unlock the applet Api_2_Aps_lvns_1 (selectable state) 

5. Send TRACE HTTP REQUEST (3) to Api_2_Aps_lvns_1 

Applet source code in doTraceO 




Check the HTTP 
RESPONSE (1): 

HTTPResponse { 

StatusCode = 
"204" 
) 

RESPONSE (2): 

HTTPResponse { 

StatusCode = 
"404" 
) 

RESPONSE (3): 

HTTPResponse { 

StatusCode = 
"204" 
) 


response. writeStatusCode (ScwsConstants . SC_NO_CONTENT) ; 



6.2.1 .2 Registration remains valid if applet is not in selectable state 

This test case is FFS. 

6.2.2 Response sending 

All tests regarding sending of a response are implicitely covered by the test cases in clause 6. 1 .5. 
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6.2.3 Exception hancJIing 



6.2.3.1 No exception shall be propagated as HTTP error to the terminal 

Test Area Reference: Api_2_Exh_Noex. 

6.2.3.1.1 Conformance Requirement 

The sews Framework implementation shall be compliant to the following statement (TS 102 588 [2], clause 4.4): 

Exceptions thrown by the invoked Applet shall not be propagated to the terminal, and the SCWS shall send an error 
status code according to HTTP 1.1[1]. In case of "chunked mode", some response data could have already been sent by 
the sews. In this case, no error shall be sent by the SCWS. In case of "fixed buffer size mode", the status code is 
always sent by the SCWS. 



6.2.3.1.1.1 



Normal execution 



CRRNl: If an exceptions thrown by the invoked Applet the SCWS send an error status code according to 
HTTP1.1[1]. 

CRRN2: In case of "chunked mode", if an exceptions thrown by the invoked Applet the SCWS and if some 
response data could have already been sent by the SCWS. Then, no error shall be sent by the SCWS. 

CRRN3: In case of "fixed buffer size mode", if an exceptions thrown by the invoked Applet the SCWS. Then, 
the status code is always sent by the SCWS. 



6.2.3.1 


1.2 


• 


n/a 


6.2.3.1 


1.3 


• 


n/a 



Parameter Errors 



Context errors 



6.2.3.1.2 Test area files 

Specific triggering: Unrecognized envelope: 

Test Source: Test_Api_2_Exh_Noex.java. 

Test Applet: Api_2_Exh_Noex_l.java. 

Cap File: Api_2_Exh_Noex.cap. 

6.2.3.1.3 Test coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 


N3 


3 
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6.2.3.1.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


1 


AoDlet throws an exceotion 


j ava . lang . ArraylndexOutOf BoundsException 
is thrown 


HTTPResponse { 

StatusCode = "500" 
) 


Byte [] array = new byte [2] 
Array [3] = 0x0 0; 


2 


In "chunked mode", aoolet 
throws an Exception AFTER 

writeStatusCode () 

enableChunkMode { ) 
writeStatusCode (200) 

Byte [] array = new byte [2] 
Array [3] = 0x0 0; 


j ava . lang . ArraylndexOutOf BoundsException 
is thrown 


HTTPResponse { 

StatusCode = "500" 
) 


3 


In "chunked mode", aoolet 
throws an Exception AFTER 

appendHeaderVariable () 

enableChunkMode { ) 
writeStatusCode (200) 
appendHeaderVariable { "a : B", 
0, 4) 

Byte[] array = new byte [2] 
Array [3] = 0x0 0; 


j ava . lang . ArraylndexOutOf BoundsException 
is thrown 


HTTPResponse { 

StatusCode = "500" 
) 


4 


In "chunked mode", applet 
throws an Exception AFTER 


j ava . lang . ArraylndexOutOf BoundsException 
is thrown 


HTTPResponse { 
StatusCode = "200" 
Header = "A: B 
Content = "OK" 

) 


appendContent { ) 

enableChunkMode { ) 
writeStatusCode (200) 
appendHeaderVariable { "A: B", 
0, 4) 
appendContent {"OK" , 0, 2) 

Byte[] array = new byte [2] 
Array [3] = 0x0 0; 


5 


IiL'tixed buffer size mode ", 

applet throws an Exception 
AFTER writeStatusCode 

writeStatusCode (200) 

Byte[] array = new 

byte [2] 

Array [3] = 0x0 0; 


j ava . lang . ArraylndexOutOf BoundsException 
is thrown 


HTTPResponse { 

StatusCode = "500" 
) 


6 


IrL'fixed buffer size mode", 

applet throws an Exception 

AFTER appendHeaderVariable 


j ava . lang . ArraylndexOutOf BoundsException 
is thrown 


HTTPResponse { 

StatusCode = "500" 
) 


{) 

writeStatusCode (200) 
appendHeaderVariable { "a : B", 
0, 4) 

Byte [] array = new byte [2] 
Array [3] = 0x0 0; 


7 


In "fixed buffer size model|j_ 

applet throws an Exception 

Ah 1 bR appendContent { ) 

writeStatusCode (200) 
appendHeaderVariable { "A: B", 
0, 4) 
appendContent {"OK" , 0, 2) 

Byte[] array = new byte [2] 
Array [3] = 0x0 0; 


j ava . lang . ArraylndexOutOf BoundsException 
is thrown 


HTTPResponse { 

StatusCode = "500" 
) 
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Annex A (normative): 

Class, methods and SCWSFramework tests acronyms 



A.1 Smart Card Web Server part 



ScwsExtensionRegistry 


Ser 


ScwsExtension 


Set 


ScwsExtensionService 


Ses 


HttpRequest 


Hrq 


HttpResponse 


Hrs 



A.1 .1 Class ScwsExtensionRegistry 



Method name 


Acronyms 


static void deregisterO 


Dreg 


static void register {) 


Regi 



A. 1.2 Class ScwsExtensionService 



Method Name 


Acronyms 


void doDeleteO 


Ddel 


void doGet { ) 


Dget 


void doHeadO 


Dhea 


void doOptionO 


Dopt 


void doPost { ) 


Dpos 


void doPut { ) 


Dput 


void doTraceO 


Dtra 



A.1 .3 HttpRequest interface 



Method Name 


Acronyms 


short f indAndCopyKeywordValue {byte [] 

headerKeywordName, short nameOffs, short nameLength, 
byte [] buffer, short bufferOffs, short maxLength) 


Fckw_Bss_Bss 


short f indAndCopyKeywordValue {short keywordid, 
byte [] buffer, short bufferOffs, short maxLength) 


Fckws_Bss 


int getContentLength { ) 


Gcle 


short getContentType { ) 


Gcty 


short getRequestHttpVersion { ) 


Grhv 


short readContent { ) 


Rcon 


short readContentType { ) 


Rcty 



A. 1.4 HttpResponse interface 



Method Name 


Acronyms 


void appendContent { ) 


Aeon 


void appendHeaderVariable {byte [] data, short offset, 
short length) 


Ahva_Bss 


void appendHeaderVariable {byte [] name, short 
nameOffset, short nameLength, byte [] value, short 
valueOffset, short valueLength) 


Ahva_Bss_Bss 


void appendHeaderVariable {short headerKeywordNameld, 
byte[] value, short valueOffset, short valueLength) 


Ahvas_Bss 
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Method Name 


Acronyms 


void enableChunkMode { ) 


Encm 


void f inalizeHeader { ) 


Finh 


void flush {) 


Plus 


int getRemainingResponseBuf f erSize { ) 


Grrs 


void reset { ) 


Rset 


void sendErrorO 


Sene 


void setContentType { ) 


Scot 


void writeStatusCode { ) 


Wstc 



A.2 Acronyms for SCWS Framework tests 



Method Name 


Acronyms 


Applet state 


Aps 


Exception handling 


Exh 



A.2.1 Applet state 



Test Area within the chapter 


Acronyms 


Invokation of applets not in state selectable 


Ivns 


Registration remains valid if applet is not in selectable state 


Regv 



A.2. 3 Exception han(dling 



Method Name 


Acronyms 


No exception shall be propagated as HTTP error to the terminal 


Noex 
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Annex B (normative): 
Test file description 



Every test source is written in JAVA^^ and shall use methods defined in Annex C interfaces to communicate with the 
card. 

In order to be more readable, data specified as method string parameters shall be presented in 4 blocks of 4 bytes per 
line. Every block is separated by a space character. Every string line is appended to previous one and shall be aligned. 
An example is provided in annex C. 

Every test file shall start with a call to reset() method. 
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Annex C (normative): 

uicc.scws.test.util package and interfaces 

See attached files: 

Annex_C_ScwsTestUtil.zip. 
Annex_C_ScwsInterfaces.zip. 
NOTE: These files are contained in archive ts_102835v070000p0.zip which accompanies the present document. 
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Annex D (normative): 
Test Area files 



See attached file: 

Annex_D_SourceCode.zip. 
NOTE: This file is contained in archive ts_102835v070000p0.zip which accompanies the present document. 



£75/ 



(Release 7) 84 ETSI TS 1 02 835 V7.0.0 (201 0-04) 

Annex E (informative): 

HTTP-Request and HTTP-Response handling 

The HttpClient V3.1 [i.2] from the Apache Software Foundation is used to handle HTTP requests and HTTP responses. 

It is permissible to use another framework for HTTP handling, in this case the interface 
ScwsApplicationManagementService has to be modified accordingly. 
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Annex F (informative): 
Bibliography 

• IETF RFC 791: "Internet Protocol". 

NOTE: Available at http://www.ietf.org/rfc/rfc79 1 .txt . 

• IETF RFC 2616: "Hypertext Transfer Protocol - HTTP/1.1". 
NOTE: Available at http://www.ietf.org/rfc/rfc2616.txt . 

• IETF RFC 793 : "Transmission Control Protocol" . 
NOTE: Available at http://www.ietf.org/rfc/rfc793.txt . 
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Annex G (informative): 
Change history 



The table below indicates all changes that have been incorporated into the present document since it was placed under 
change control. 



Change history 


Date 


Meeting 


Pienary Doc 


RQ 


Rev 


Cat 


Subject/Comment 


Old 


New 














Creation of the specification 




7.0.0 
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History 



Document history 


V7.0.0 


April 2010 


Publication 



























£75/ 



